USING THE DEMONSTRATION DISKS 


WARNING - BEFORE USING THESE DEMONSTRATION DISKS, READ THE 
INTRODUCTION SECTION OF YOUR USER'S MANUAL. 


SAVVY One System 


The SAVVY One demonstration disk is intended for use by 
owners of systems equipped with either one or two disk 
drives. The disk illustrates several different applications 
of the SAVVY language. Although written in an educational 
context, the techniques illustrated may be used in many 
situations outside of the education setting. The disk is 
configured for an eighty column display. To reconfigure the 
disk for a forty column CRT display, see the section 
"Configuring Your System" in the User's Guide. To start the 
demonstration, turn off the computer, place the disk in 
drive 1, close the disk drive latch, and turn the computer 
on. The demonstration disk will start automatically. 


SAVVY Two System 


The SAVVY Two demonstration disk may only be used with 
a two disk drive system, and should be placed in drive 2. 
Essentially, the material on the "two drive" demonstration 
disk repeats material contained in the user's manual. To use 
the two drive demonstrator, turn your computer off, place 
the two drive master in drive 1 and the two drive demo in 
drive 2, close the latches on both disk drives, and turn the 
computer on. 
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INTRODUCTION 
Section 1: What is SAVVY? 
Section 2: Getting Started 
Section 3: Making Backups 
Section 4: Configuring Your System 
Section 5: The Keyboard 
Section 6: What SAVVY Knows 
Section 7: For hard-disk Users 


Section 1: WHAT IS SAVVY? 


SAVVY is the PERSONAL LANGUAGE (tm) system that recognizes and responds to your 
own words. Superficially, most traditional computer systems recognize human 
language, but only within a very rigid structure of specific commands that 
produce specific actions. They cannot process any information that they have not 
been specifically programmed to recognize. In addition, traditional systems 
require very precise syntax and spelling - every communication must be perfect, 
no misplaced commands, and no misspelled words. 


SAVVY is different. SAVVY Processes queries and directives and performs the 
specified actions just like traditional systems, but it will also attempt to 
respond appropriately to messages from you that are not exactly like the things 
it has been programmed to recognize. SAVVY is capable of accepting minor 
misspellings and transposed letters. It will try to figure out what to do with 
an unfamiliar message rather than simply displaying a terse ERROR message 
stating that you did something wrong. 


What makes SAVVY so different is pattern recognition. SAVVY attempts to relate 
the pieces of an unfamiliar message to something that already exists in the 
collection of information it received at the factory or that you have added. It 
will interact with you to interpret a previously unrecognized word or phrase 
into a message to which it will be able to respond with a specific action. It 
builds a unique, internal vocabulary that is based on patterns and experiences 
you provide. SAVVY is, in a sense, learning a "foreign" language from you. It 
has its "tourist guidebook" of words it learned at the factory. These words, 
like the "tourist guidebook" phrases: "Where is the bus stop?" and "How much 
does it cost?" while quite essential, are not terribly interesting and your 
initial communications with a new SAVVY system may not seem too remarkable. 
However, as you use SAVVY, its vocabulary will continue to expand and its 
knowledge will become more extensive. SAVVY's pattern recognition will adapt to 
your manner of expression so that it will seem to develop an uncanny ability to 
understand what you mean. 


The most important element in SAVVY's evolution from eager apprentice to 
valuable assistant is -- USE. The more you use SAVVY, the better it gets. SAVVY 
will become easier and more efficient to use because it will "know" what you 
mean. This is in direct contrast to the static essence of traditional systems, 
The only reason they become easier to use is that YOU become trained to adapt to 
their structure, and the precise way data must be entered to avoid the tiresome 
ERROR messages that result if you don't do things their way. 


SAVVY is dynamic. It changes to suit your needs. You train IT to adapt to YOUR 
manner of expression. SAVVY's potential will be limited only by how you choose 
to take advantage of the resources available to you. 
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SOME SAVVY PRELIMINARIES 


The first thing you need to do with SAVVY is copy the disks that came with this 
manual. All of the directives and terms that will be used to describe the copy 
process will be explained carefully and step by step instructions will be 
displayed on the screen as you are making the copy. Before you start this 
process, here is a brief explanation of some of the basic conventions of 
communicating with SAVVY. These are explained in detail later, but are presented 
briefly at this time so you will know how to correct minor errors that might 
occur. 


After you type an instruction to SAVVY, you must press the RETURN key. This 
tells SAVVY that it is to look at what you typed and to act accordingly. In the 
instruction for the first several operations, the notation <R> is used to remind 
you to press the RETURN key. After a little work with SAVVY you will develop a 
feel for when to press RETURN. 


In many instances, after you type a directive to SAVVY, another phrase is acded 
to the screen as soon as you press RETURN. To illustrate this in this manual, 
everything you type is in CAPITAL letters and SAVVY's responses are in lower 
case letters. This is the same way the screen will look if you are using the 
Videoterm card or an Apple IIe. If you are working in the Native Apple 40 
character UPPER case only mode, everything on the screen will be in capital 
letters. 


If you make a mistake while typing a directive to SAVVY, press the left-pointing 
arrow to back up the cursor (the flashing white square that precedes each typed 
character) up to the mistake. Then type the correction. Each time you press this 
key, the cursor will back up one character erasing that character. 


Never use RESET to load a new SAVVY DATA disk in the Apple or to stop anything 
that is in progress. The RESET interrupts the CPU and leaves no way to get back 
to whatever was going on at the time. If this happens, SAVVY assumes your data 
disk may be in trouble, and will remind you of this until you SUMMON the 
DIAGNOSTICS. 


When you want to stop an unwanted operation, use the ESC key and then press'the 
F key. This will return you to the point where SAVVY asks "What would you like 
me to do now?" The ESC key is explained fully on page 13. 


When you want to stop working and turn off the computer or if you want to load 
a new SAVVY DATA-DISK, make sure that the message "What would you like me to do 
now?" is the last line displayed on the screen. Turn the computer off, remove 
the DATA-DISK from Drive 2, insert the new DATA-DISK in Drive 2, and turn the 
computer back on. 
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The standby task ARCHIVE will only make copies from diskette to diskette or 
between diskette and the Corvus. To make a backup from the Corvus to a video 
cassette recorder, follow the instructions beginning on page 25 of this chapter, 
entitled MAKING BACKUPS FOR THE CORVUS. 


MAKING BACKUPS FOR A TWO-DRIVE SYSTEM 


Put the SAVVY MASTER disk in Drive 1 and a new BLANK disk in Drive 2. You use a 
blank disk at this time, because the system will not load material from the disk 
properly with a "write protected" disk in Drive 2. 


On the Apple II+, SAVVY must be started up initially using the 40 column upper 
case only mode. If you are using the VIDEX card, plug the monitor into the jack 
in the back of the Apple instead of plugging it into the cable from the VIDEX 
card. If you are using an Apple Ile be sure the CAPS LOCK key is down. 


Turn the computer on. Drive 1 will "whir" for a couple of seconds. When it 
quits, Drive 2 will "whir" for just a second then your computer will "beep", and 
the screen will display the HELP MENU. This menu is explained fully on page 17. 
The HELP MENU looks like this: 


Something unusual has happened... 


I was expecting to find a good DATA-DISK 
in Drive #2 but there wasn't one there. 


CHOOSE one of the following actions: 


1) You put a good data-disk in Drive #2 
and I'll try again. - 


2) I'll go o the CONFIGURATOR standby 
task and you can make a new clean 
data-disk. 


3) I'll go to the UTILITIES standby task 
which will describe other choices. 


ENTER the NUMBER of desired action: 


Number 3 is the selection to use. NOTE that when SAVVY asks you a question that 
can be answered with one character you do not need to press the RETURN, just 
press one character. SAVVY has been taught to accept only 1 character before 
acting. If a question can be answered YES or NO, just press the Y or N. 


Press the number 3. The screen will clear again, and you will be shown the 


UTILITIES MENU. The UTILITIES MENU will be explained fully beginning on 
page 18. 


The UTILITIES MENU looks like this: 
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It takes about a minute and a half to make a copy. At the same time SAVVY is 
making the copy it is also verifying the copy. If a copy cannot be verified, 
SAVVY lets you know so that you can try again. When the copy is finished, SAVVY 
displays on the screen: 


Good copy 


Press any key when ready to continue. 


When you press another key, you will be shown 


REMOVE your new copy from Drive #1 then 
RESTORE diskettes to original drives 


Press any key when ready to continue. 


When you press a key, you will be returned to the ARCHIVE MENU. Make at least 
one copy of each of the disks that came in this manual following these same 
steps. 


We recommend that you make at least two additional copies of the disks that you 
will be using. It is easier to work with confidence on a new system when you 
know that no matter what happens to the disks you are working with you always 
have a good backup copy. When you are working with any system, always make 
multiple backups. 
If you copied all of the disks for your system, you should now have 6 disks with 
which to work. Put a copy of SAVVY One DEMO in Drive 1. Press 5 to leave the 
ARCHIVE MENU. The next screen display will tell you how to get started using the 
DEMO disk. 
MAKING A BACKUP FOR A ONE-DRIVE SYSTEM 
1) Type SUMMON<R> 
The system adds "the standby task" 
2) Type <R> 
The system displays the UTILITIES menu: 
UTILITIES MENU 
l. Make an exact copy of this diskette. 
2. Perform system diagnostics. 
3. CONFIGURE for different hardware. 
4. ALL DONE WITH HELP. Go back to 
"What would you like me to do now?" 
ENTER the NUMBER of the desired action: 
3) Type: 1 


The system displays the following message: 
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Section 4: SETTING UP SAVVY TO COMMUNICATE WITH YOUR HARDWARE 


It is important for SAVVY to know exactly what hardware you have in your system. 
SAVVY communicates with different types of hardware in different ways. For 
example, if you are using a VIDEX Videoterm card for an 80 column display and 
SAVVY has not been so informed, it will only communicate with you using the 
first 40 columns of your screen. 


Until you tell SAVVY which printer interface card you are using, you will not be 
able to print anything. The disk was configured this way to prevent accidental 
damage to the information on the disk, which may be caused by trying to send 
data to a printer interface card that was configured improperly. 


The configuration of your system is put on the SAVVY MASTER disk, so that you do 
not need to configure every DATA-DISK that you will be using. The SAVVY MASTER 
disk that you received is configured for the following type of hardware: 


Native Apple (40 coiumn upper case only display) 
No printer card 
2 Floppy disks 


The SAVVY One disk is configured for: 


Native Apple (40 column upper case only display) 
No printer card 


SAVVY PRO CONFIGURATION 
You may reconfigure the system to support the following: 


Videx Videoterm card with or without a Soft Switch (80 column 
display) 

Videx Enhancer (40 column display using upper and lower case 
letters) 

APPLE Ile 40 column upper and lower case display 

APPLE Ile 80 column text card 

APPLE Parallel printer card 

CCS 7720 Parallel printer card 

CCS 7710 Serial printer card 

2, 3, or 4 Floppy disk drives (5 1/4 inch single sided APPLE 
compatible drives) 

Corvus hard disk drive (up to 20 megabytes may be configured. 


SAVVY will ignore any other cards in the system. 


If you are not going to change the configuration of your disk, just read the 


section CONFIGURING THE SYSTEM, and continue working at the section THE 
KEYBOARD. 


If you are going to change the system configuration so that you can use an APPLE 
Ile, the VIDEX card, a printer, or any of the optional hardware, follow the 
steps in the next section CONFIGURING THE SYSTEM. 


_ 
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Which CRT (Monitor) will you be using? 
(Asterisk shows present configuration) 


* 1) 40 column native APPLE screen 

without lower-case 

2) 40 column native APPLE screen 
with lower-case 
(Special equip. or Ile req'd) 

3) 80 column VIDEX VIDEOTERM 
(special equip. req'd) 

4) 80 column native APPLE screen 
(IIe req'd) 


ENTER the NUMBER for desired CRT. 
Selection number 1 will work on all APPLE II+ and APPLE Ile computers. 


Selection number 2 will work on all APPLE IIe computers and on an APPLE 
11+ with a VIDEX ENHANCER. 


Selection number 3 is for APPLE 11+ and APPLE Ile computers with a VIDEX 
VIDEOTERM CARD, with or without the Softswitch. 


Selection number 4 is only for APPLE IIe computers with the APPLE 80 
column text card. 


Choose the appropriate selection for your computer, or press the RETURN to stay 
in the present configuration (indicated by the *). When you do, the following is 
displayed: š 


Which printer interface would you like? 
(Asterisk shows present configuration) 


1) APPLE parallel 
2) CCS 7728 parallel 
3) CCS 7710 serial 

* 4) No printer present 


ENTER the NUMBER for desired PRINTER 


Selection number one will support the APPLE parallel interface card and the 
following other cards: 


EPSON APL board 


MPC AP-80 APPLE parallel interface 
ASAP APPLE/EPSOM parallel interface 


MICROTEX 9V611C parallel interface 


Selection number two will support the CCS 7728 and CCS 7729 parallel interface 
cards. 


Selection three will support the CCS 7710A serial interface card. 


Enter the number corresponding to the printer interface you are using. When you 
do, the following is displayed: 
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Section 5: THE KEYBOARD 


Now that you have made copies of your disks and configured the SAVVY MASTER to 
communicate with your system you can begin to learn about SAVVY by using SAVVY. 
First, however, you should learn the function of some of the keys on the 
keyboard that have special meaning to SAVVY. Descriptions of keys that are 
unique to either the Apple II+ or the Ile are indicated. 


1. RESET 


As mentioned earlier, never press the RESET (called CONTROL-RESET on the Apple 
Ile) key. If you are accustomed to using your Apple II+ in the standard manner, 
it might seem easier to press RESET when starting up the system or reloading 
rather than using the power switch on the back of the Apple to turn the power on 
and off. Here's what happens to SAVVY if you press RESET on your Apple II+: 


The information that is temporarily stored in memory is not transferred to the 
disk properly. This will not necessarily lead to an immediate or obvious failure 
and you may not notice any immediate consequence of using RESET. The errors will 
be there, however, and as you continue to use the disk the errors will spread 
and contaminate other data on the disk. When you make a backup of the 
error-carrying disk, the errors are perpetuated. Eventually, all of the data 
that you have entered will be contaminated and the only way to use this disk 
will be to reformat it and start over. 


-- NOTE 

You can protect yourself from this problem. To do it, turn off the 
power to the computer and remove the cover from the keyboard unit. 
Looking down into the machine, you will see a printed circuit board 
attached to the keyboard that appears to hang above the motherboard. 
On the left side of this board is a small switch labeled: CNTL RESET. 
Flip the switch to the CNTL position. Now the RESET switch will only 
work if you press the CONTROL key at the same time as the RESET key 
("Control Reset"). CONTROL-RESET works the same as RESET on 

all non-SAVVY programs, but your SAVVY system is a little safer. 
CONTROL-RESET is standard on the Apple Ile. 


RESET is not the only way that data in memory and on the disk can be disrupted. 
A power failure or unstable power conditions can have the same effect. In 
addition, sometimes a major appliance, such as an air conditioner, can 
momentarily disrupt power when it is turned on. DO NOT USE your SAVVY system 
during an electrical storm or during any other conditions where the power might 
not be stable. 


2. ESCAPE (ESC) 

ESCAPE is used to terminate a SAVVY operation. It can be used to bail out of a 
mistake or stop whatever SAVVY happens to be doing. When you press ESC, SAVVY 
will display the message: 


Finsned, Resume, or Suspend? 


You respond by typing either F, R, or S. 
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F (Finished) F terminates whatever SAVVY was doing and goes back C 
to "What would you like me to do now?" This is the way to 
end an operation that you realize is wrong or undesireable. 

R (Resume) R tells SAVVY to pick up where it left off. For instance, 
if you accidentally press the ESC, it will stop SAVVY at that 
point in whatever it is doing. If you then press the R, SAVVY 
will start up again where it left off. 

S (Suspend) is used in two drive systems only. 

It is used to Suspend the operation and transfer all 
information in temporary memory to the SAVVY MASTER disk. This 
exit can be particularly useful when you are in the middle of 
an important procedure and something else needs your immediate 
attention. When you press S, SAVVY stops whatever it is doing 
and transfers everything to the disk. When this is accom- 
plished, the following appears on the screen: 


I am now suspended. Please turn off the power. 


When "suspended" disks are placed in the proper drives and the 
power is turned on, it will come up at the same point at which 
it left off. Suspend is a good way to shut down your work vien 
there are potentially unstable power conditions. 


IMPORTANT: When disks have been suspended, they are functionally 

bound together. They can not be successfully used separately 

until they have been reloaded and allowed to run to the end of Ye 
the suspended task (the READY MESSAGE is displayed). 

IF YOU TRY TO USE EITHER OF THE SUSPENDED DISKS WITH ANOTHER 

DISK, SERIOUS ERRORS WILL OCCUR. 


3. REPT (APPLE II+ ONLY) 


The REPT key functions the same with SAVVY as it does with BASIC. If you hold 
down any key and press REPT, the character will be repeated until ore of the 
keys is released. 


4. RETURN 


When you configured the system, you learned that the RETURN key is used as a 
message to SAVVY that you have typed something that it should now examine and 
act upon. Here are a few more examples using the RETURN. (The words that you 
type are shown in UPPER CASE characters and SAVVY's responses are in lower case. 
Don't forget that the symbol <R> indicates that you should press the RETURN key. 


DEFINE<R> a task called SAMPLE TASK <R> 
LIST<R> the INDEX<R> of folder called DICTIONARY<R> 
IF<R> the PAGE<R> IS<R> EMPTY<R> then 
Again don't forget you will not be shown the return notation <R> in all of the 


examples because you will soon develop a sense of when to press the RETURN. If 
in the second example you were in the FREE mode (explained later) and you typed: 
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LIST THE INDEX<R> 


SAVVY would respond by ringing the bell and replacing what you entered with: 


LIST the 


This occurs because SAVVY knows the primary LIST, but it has not been taught 
LIST THE INDEX. 


5. CONTROL (CTRL) 


The CONTROL key is used to produce characters that do not appear on the keyboard 
of the APPLE. Control is always used in conjunction with another key. That is, 
you hold down CONTROL and press another key to perform a specific act or 
generate a new character. For instance, pressing the control key and the "K" 
produces the right square bracket ]. 


CONTROL A: by pressing the CONTROL key and the A key at the same time, you 
switch the upper case user communication to lower case and pressing it again 
causes it to change back again. On an APPLE II*, this will only be displayed on 
the screen if you are using the VIDEX enhancer or the VIDEX Videoterm. The 
Native Apple II+ screen will not show lower case letters, but you are still 
capable of sending them to SAVVY using CONTROL A. If you are working with the 
Upper Case only screen and you come to a point at which SAVVY does not seem to 
be able to recognize any commands, press CONTROL A (in case you accidentally 
shifted into the lower case mode) and try a command that you are sure SAVVY 
knows. 


6. LEFT-POINTING ARROW (<) 


The LEFT ARROW is used like the backspace on a conventional typewriter. It also 
deletes the characters it backs over. When you back over characters to correct a 
typographical error, you must retype all of the characters you backed over 
before you reached the mistake. When you backspace to the end of the line, SAVVY 
will "BEEP" and not let you backspace any further. Once you have typed in 32 
characters, you cannot backspace past the 32nd. You may backspace from character 
number 255 to 32. 


7. RIGHT-POINTING ARROW (>) 


SAVVY uses the right pointing arrow as a "delete" key. When you press this key, 
you will delete everything you typed since you last pressed the RETURN key. 


8. UP ARROW (APPLE Ile ONLY) 

The up pointing arrow produces the character [. It will not move the cursor up. 
9. DOWN ARROW (APPLE Ile ONLY) 

SAVVY treats the down pointing arrow as a RETURN. 

10. TAB (APPLE Ile ONLY) 


Pressing the tab key has the same effect as pressing the RETURN. 
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11. DELETE KEY (APPLE Ile ONLY) 


The DELETE KEY produces a special character, and has no other effect with SAVVY. 


12. CAPS LOCK (APPLE Ile ONLY) 


The CAPS LOCK key should always be depressed when you are using SAVVY. 


13. OPEN-APPLE & SOLID 


These two keys have no 


Below is a list of the 
list to get an idea of 
describes what each of 


APPLE (APPLE Ile ONLY) 


effect with SAVVY. 


Section 6: WHAT SAVVY KNOWS 


commands and primaries SAVVY knows. Browse through the 
SAVVY's beginning vocabulary. The reference section 


these words does. The programming section will 


provide 


practice in using them. Generally, the commands are used when SAVVY is at the 
command level or when the "ready message" is displayed. Primaries (and other 
words SAVVY knows) are used within tasks (or programs) to instruct SAVVY to 

perform specific activities. 


FACTORY LEARNING 


When you create a "Clean DATA-DISK", it will contain the following data from the 


education SAVVY was given at the factory: 


PRIMARIES 

ADD ASSIGN 
CURSOR CUT 
DUPLICATE END 
GENERATE GET 
LABEL LAYOUT 
OTHERWISE OUTPUT 
READ REPEAT 
SECURE SHOW 
TAKE THAW 
COMMANDS 

ASSOCIATE CREATE 
ITEM JANITOR 
WORDING 

ITEMS 

ANSWER BACK 
FRACTION FRONT 


LENGTH OF PROMPT 
PRODUCT QUOTIENT 


BEGIN CARRIAGE CLEAR 
DELETE DISPLAY DIVIDE 
ERASE FILL FREE 

GO HALT LF 
LEAVE LIMIT LITERAL 
PASTE PRESERVE PRINT 
REPLACE RETURN RING 
SPLIT START SUBTRACT 
WHEN 

DEF INE DETAIL FORGET 
LIST PAPER RENAME 


DIFFERENCE DISK TITLE EMPTY 
ID INTEGER LENGTH 
LENGTH OF SHOW NO 
RESIDUE SUM VERSION 


COPY 

DO 
FREEZE 
INPUT 
MULTIPLY 
PROMPT 
SAVE 
SUMMON 


FUNCTION 
USAGE 


ERROR 


PAGE 
YES 


p 
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TASKS FOLDERS 
REPORT ASSIGN ERROR (Undefined) DICTIONARY 


REPORT DELETE ERROR (Undefined) 
REPORT GET ERROR (Undefined) 
REPORT MATH ERROR (Undefined) 
REPORT REPLACE ERROR (Undefined) 
REPORT SAVE ERROR (Undefined) 
STARTUP (Undefined) 


First explore your Demo disks to get a feeling for the types of things SAVVY can 
do. When you are comfortable with using the demo disks, go on to the programming 
section. Once you have finished the programming section, you can gain other 
programming insights by studying the tasks on the demo disk. You can print out 
listings of all the demo tasks. 


The remainder of this section discusses each of the standby tasks. 


THE STANDBY TASKS 


The standby tasks perform specialized systems operations. Since they are seldom 
used more than a couple of times a work session, they are not transferred to 
temporary memory until they are called. You can use these tasks by typing: 


SUMMON the standby task 


Then type a quotation mark and the name of the standby task. You must use the 
beginning quotation mark, because the standby tasks are not listed with the 
regular tasks. 


The one standby task that is invoked automatically is the HELP MENU. This is 
invoked if you try to boot the system without a DATA-DISK (in a two-drive 
system), with an unformatted DATA-DISK, or with a bad disk in Drive B. It gives 
you the option of trying again, going to the CONFIGURATOR, or calling up the 
UTILITIES MENU and using one of the selections from that menu. The HELP MENU 
looks like this: 


Something unusual has happened. 


I was expecting to find a good DATA-DISK 
in Drive #2 but there wasn't one there. 


CHOOSE one of the following actions: 


1) You put a good data-disk in Drive #2 
gand I'll try again. 


2) I'll go to the CONFIGURATOR standby 
task and you can make a new clean 
data-disk. 


3) I'll go to the UTILITIES standby task 
which will describe other choices. 


ENTER the NUMBER of desired action. 
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J- 


Selection number 1 will allow you to do a restart without turning the 
machine off and on. Just change DATA-DISKS and then press the number 1. 


Selection number 2 will bring up the CONFIGURATOR MENU from which you 
can make another selection. 


Selection number 3 will show the UTILITIES MENU from which you can 
choose one of the other standby tasks, like ARCHIVE. 


If you have trouble remembering the exact spelling of the standby task you want 
to use, you can type: 


SUMMON the standby task "" 


This brings up the UTILITIES MENU which lists the three standby tasks and allows 
you to pick one just by specifying the appropriate number. 


The UTILITIES MENU looks like this: 
EXPLANATION of STANDBY TASKS 


1) ARCHIVE is used to make copies of 
disks. It can also be used to do 
special disk related operations. 


2) CONFIGURATOR is used to tell SAVVY 
what hardware is in your system = 
and to make clean data disks. 


3) DIAGNOSTICS is used to test the 
integrity of the data on your data- 
disk. It can also clear the 'your 
disk may be in trouble' message. 


4) All done with UTILITIES...Go back to 
"What would you like me to do now?" 


ENTER the NUMBER of desired action. 


Selection 4 of the UTILITIES MENU will restart the system. The rest of the 
selections are discussed in the following paragraphs. 
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ARCHIVE 


The standby task ARCHIVE is used to make copies of your disks and to perform 
special disk related diagnostics routines. The ARCHIVE MENU looks like this: 


-- ARCHIVE MENU -- 


1) Copy diskettes. 

2) Show the diskette drive numbers. 

3) Copy between hard-disk and diskettes. 

4) Use the SPECIAL disk utilities and 
diagnostic routines. 

5) All done with ARCHIVE...Go back to 
"What would you like me to do now?" 


ENTER the NUMBER of desired action. 
SELECTION 1) COPY DISKETTES. 


This selection is used to copy information from one diskette to another. It is 
explained fully on page 6 of this section. 


SELECTION 2) SHOW THE DISKETTE DRIVE NUMBERS. 


This selection will show you which disk drive SAVVY recognizes as Drive $i, 2. 
3, and 4. 


SECTION 3) COPY BETWEEN HARD-DISK AND DISKETTES. 


This selection will show you its own menu. With it you have the following 
options: 


1) HARD-DATA-DISK to DISKETTE COPY 
2) DISKETTE to HARD-DISK COPY 


Before you are shown this menu, you are asked if your system has more than 1 
disk drive. This will allow you to make your copies to or from Drive l if you 
have only one disk drive. Otherwise, you will be making your copies to and from 
Drive 2. 


1) HARD-DATA-DISK to DISKETTE COPY 


This selection gives you the opportunity to back up your Corvus hard disk on 
floppy disks. When using this selection, SAVVY asks for the beginning boundary 
of your DATA-DISK, then it checks to see if there is a DATA-DISK beginning at 
that boundary. When it has verified the existence of the DATA-DISK it will show 
you how many disks will be needed to do the backup. If you are not using all of 
the space that you are configured for, you might consider shortening the length 
of the DATA-DISK using the CONFIGURATOR menu and then doing your backup. That 
will not only save time, it will also save diskettes. Refer to page 24 for an 
explanation of this procedure. Remember, if you do shorten the length of the 
DATA DISK, you will need to extend it when you have finished making your backup. 
This is also explained on page 23. 


When SAVVY is ready it will tell you to enter disk A and press any key. It then 
copies information to that disk. It continues telling you which disk to enter 
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until the backup is complete. Be sure to label the diskettes using the same C 
letter you are shown on the screen. Without the correct letter, the disk cannot 
be copied back onto the Corvus properly. 


This set of disks can then be used to copy back on to the Corvus at a later 


date, or to build the DATA-DISKS on another Corvus without have to worry about 
whether the second Corvus is compatible with the first. 


This selection will not make a copy from the Corvus hard disk to a video 
cassette recorder. To do that, refer to the section on using the special SAVVY 
BACKUP UTILITY PROGRAM titled MAKING BACKUPS ON THE CORVUS beginning on 

page 25. 


2) DISKETTE to HARD-DISK COPY 


The procedure to copy from diskettes to the Corvus allows you to build a 
DATA-DISK on your hard disk from a set of diskettes that have been taken off the 
same or another Corvus. This procedure will not allow you to put two unrelated 
disks onto the same section of the Corvus. 


When you use this procedure, you will be asked how many disks are going to be 
installed (1-26) and what boundaries you are going to use. SAVVY then asks you 

to enter the disk A, it copies that disk and (if there are more) asks for the 
next disk. When all the disks have been copied, you are returned to the ARCHIVE 
MENU. If you have used the same boundaries for your new DATA-DISK as the ones 
already on the SAVVY MASTER disk, when you exit from the ARCHIVE MENU you will 

go to the READY MESSAGE. If the boundaries are different than the ones on the ~œ 
SAVVY MASTER disk you will invoke the HELP menu and you can proceed from there 

to reconfigure the SAVVY MASTER disk. 


SELECTION 4) USING THE SPECIAL DISK UTILITIES AND DIAGNOSTICS ROUTINES 


The menu that is presented when this selection is chosen contains routines that 
will work on the floppy disk drives only. You probably will not use these 
routines very often, but they will be there if they are needed. These routines 
are: 


UTILITIES AND DIAGNOSTICS 


1) Show the diskette drive numbers. 

2) Format the diskette in drive #n. 

3) Show me the disk speed for drive ۰ 

4) Read-check a diskette for me. 

5) Test disk surface and Drive tolerances. 
6) Compare diskettes in drives 1 & 2. 

7) Let me see the ARCHIVE menu again. 


ENTER the NUMBER of desired action. 
1) SHOW THE DISKETTE DRIVE NUMBERS. 


This selection will show you which drive SAVVY recognizes as Drive l, 2, 3, and 
4. 


2) FORMAT THE DISK IN DRIVE £n. 
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Use this selection to physically format any disk that you want to use for SAVVY. 
This procedure prepares the disk to receive data, but does not do the complete 
initialization procedure that is done when you make a "clean data disk". Before 
this can be used as a "Clean DATA-DISK", you will need to use the selection of 
the CONFIGURATOR MENU to make a Clean DATA-DISK. You should use this format 
procedure on a disk that does not show an ok in the Media portion of the 
DIAGNOSTICS report. 


3) SHOW ME THE DRIVE SPEED FOR DRIVE #n. 


There are two types of tests to check the drive speeds, DESTRUCTIVE and 
NONDESTRUCTIVE. The DESTRUCTIVE test will erase (destroy) data on the diskette 
as it shows you the drive speed. The NONDESTRUCTIVE will not harm any data on 
the disk while it shows you the drive speed. The drive speed is shown in RPM. 
The optimum drive speed suggested by APPLE Computer, Inc., is 299.5 rpm, but 
SAVVY will usually handle drive speeds between 285 and 309 rpm. 


4) READ-CHECK A DISKETTE FOR ME. 


This procedure is used to determine if all of the physical blocks on the 
diskette can be read. Passing this test does not insure the integrity of the 
information, but failing this test usually indicates a serious physical problem 
with the disk. You probably would not be able to make a copy of this disk. This 
is a NON-DESTRUCTIVE procedure. 


5) TEST DISK SURFACE & DRIVE TOLERANCES. 


This is a two-part procedure, a media test and a drive test. The media test 
writes, then reads Os, then ls on all tracks of the disk. The drive test writes 
and then reads random data on randomly selected tracks. THIS IS A DESTRUCTIVE 
TEST. It will erase all of the data on the disk being tested. BE SURE YOU HAVE A 
BACKUP BEFORE RUNNING THIS TEST. Failing this test is indicative of a bad 
diskette or a disk drive in need of maintenance. 


6) COMPARE DISKETTES IN DRIVES 1 4 2. 


You may have times that you have two diskettes that should be identical, but you 
are not sure. Using this procedure allows you to compare the information on 
these two diskettes. If any blocks are different, the block numbers will be 
shown on the screen. 


7) LET ME SEE THE ARCHIVE MENU AGAIN 


When you are finished with this menu, use this selection to return to the 
ARCHIVE MENU. 


The last selection in the ARCHIVE MENU is used when you are finished with 
ARCHIVE and are ready to go back to work. When you use this selection, SAVVY 
will do a restart. : 


As mentioned in the topic oq making a backup, copying your DATA-DISK after each 
work session is one of the most important procedures you will do. To help insure 
that you will be making a copy of a good DATA-DISK, use the standby task 
DIAGNOSTICS before using ARCHIVE. 
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You should not make a backup of a disk that has been diagnosed as being bad. C 
Once the data on the disk has been damaged, there is nothing you can do to : 


restore it. If you use ARCHIVE to copy a disk with bad data on it, the bad data 
will be transferred with the good. 


CONFIGURATOR 


The major purpose of the CONFIGURATOR is to establish communication between 
SAVVY and the various items of hardware in your system. It will also make a 


clean DATA-DISK, and expand the length of your DATA-DISK. The CONFIGURATOR MENU 
looks like this: 


-- CONFIGURATOR MENU -- 


1) Make a CLEAN new DATA-DISK. 

2) Change the Hardware Configuration. 
(Monitors, Printers, Disk-Drives) 

3) Extend the length of the DATA-DISK. 

4) Shorten the length of the DATA-DISK. 

5) All done with CONFIGURATOR...Go back 
to "What would you like me to do now?" 


ENTER the NUMBER for desired action: 


When you are finished with this menu and are ready to go back to the READY k. 
MESSAGE use Selection 4. - 


SELECTION 1) MAKE A CLEAN NEW DATA DISK. 


Selection number 1 will allow you to make a new clean DATA-DISK. A "clean" DATA 
disk contains only the SAVVY basic vocabulary. When you use this selection, it 
explains what this procedure will do and asks if that is what you want done. 
Then it shows you what it recognizes as the DATA-DISK (the drive number or the 
section, in the case of the Corvus). Again it will ask if that is what you want 
to do. If you answer YES, it then erases all of the data on the disk, and copies 
SAVVY's beginning vocabulary onto that disk so that you can start from the 
beginning in building an application. 


A "clean" DATA disk will work a little differently than the disks that came in 
this package. When you turn on the computer using a "clean" DATA disk, the 
following will be displayed. 


STARTUP (Undefined) 
What would you like me to do now? 


This is because the first thing that is done when you turn on the machine is the 
task STARTUP. On the disks that came with this manual, the STARTUP task is what 
shows the copyright notice and asks you to "Enter TODAY'S DATE". It is not 1 
defined on a "clean" DATA disk. It will be up to you to define STARTUP if you FT 
want it to do something special. The procedure to do this is explained in the 
BEGINNERS SECTION beginning on page 60. 


When you work with a "clean" DATA disk, YOU define all the tasks you want it to 
contain. That includes not only applications tasks, but also tasks that display 
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messages reporting errors. In a sense, you are creating a “custom disk". You put 
on it only the tasks and functions you will need. The majority of the disk is 
then available for data storage. 


For example, if you decide that you want to use tasks from another disk as part 
of a new operation you are creating, you could DETAIL those tasks and use them 
as models for entry on your new DATA disk. 


You can even DEFINE a "custom" STARTUP task of your own that displays a 
descriptive message -- something like: 


EAST SIDE ELEMENTARY STUDENT RECORDS 
in place of the standard STARTUP task furnished on the disk. 
SELECTION 2) CHANGE THE HARDWARE CONFIGURATION 
This selection is explained in detail on page 9 of the INTRODUCTION SECTION. 
SELECTION 3) EXPAND THE LENGTH OF THE DATA DISK 


Selection number 3 will let you expand the boundaries of your DATA-DISK. For 
example, if you are working with just two disk drives and want to add a third, 
you would use this selection to tell SAVVY when you have added the additional 
drive to your system. This selection will take care of reconfiguring the MASTER 
disk and expand the length of your DATA-DISK to span two disk drives. You would 
also use this if you were working with a hard disk system set up for a 1 
megabyte data set and wanted to expand it to 2 megabytes. 


SAVVY first shows you the present configuration, then asks how much more space 
you want to add. It then checks to see if you have enough space available to 
make the addition. If there is enough space, it reconfigures the MASTER and 
expands the length of the DATA DISK. Remember that a reconfigured MASTER (now 3 
drives) will require a disk in both data drives, and some other data set that 
was only on one DATA-DISK would not work. If some data sets are on two DATA 
disks and others use just one, you would need to have a MASTER configured for 
three drive operations and another one configured for two drive systems. 


SELECTION 4) SHORTEN THE LENGTH OF THE DATA-DISK 


This selection allows SAVVY to condense the information on the data disk to the 
smallest possible space. It is mainly useful when you want to make a backup of a 
hard-disk. When you make a backup from the hard disk to floppy disks, you copy 
the space that has been configured, regardless of whether it has data in it or 
not. This selection allows you to condense actual data into the smallest 
possible space, and thereby eliminates copying unused disk space. It saves time 
and floppy disks. When you have finished making the backups. you can extend the 
length of the DATA-DISK to its original length using selection three of the 
CONFIGURATOR menu. ; 


DIAGNOSTICS 


The standby task DIAGNOSTICS checks various aspects of the SAVVY system to make 
sure they are functioning properly. Use this task if you suspect a problem and 
before you make a backup to make sure the disk from which you are copying (the 
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source disk) is good. If there are any major disk problems while you are Al 
working, SAVVY will display this message: 


Your disk may be in trouble, try DIAGNOSTICS. 
You can run DIAGNOSTICS by typing either: 


SUMMON the standby task "DIAGNOSTICS" 
or 
SUMMON the standby task "" 


The first alternative calls up the standby task by name and the second calls up 
the UTILITIES MENU, from which you can select DIAGNOSTICS. 


SAVVY will proceed with a series of tests that check the card and the disks. 
When DIAGNOSTICS has finished running, the following is displayed if there is an 
error: 


COMPUTER: The CPU is functioning incorrectly. 

MEDIA: The DATA-DISK in the machine cannot be read. 

FIXED ASSIGNS -- ORPHANS: The logical structure of the informa- 
tion on the MASTER disk is incorrect. 


Press any key to continue 


When you press a key, SAVVY will do a restart. & 
Only the "Press any key..." message will be displayed if the system passes the 
DIAGNOSTICS. 


USING SAVVY ON MORE THAN TWO DISK DRIVES 


When you use more than two disk drives, SAVVY considers all the drives except 
the first as one large DATA-DISK. All of the DATA-DISKS in a multiple DATA-DISK 
system may start as one clean DATA-DISK, or you can expand a single DATA-DISK to 
a multiple disk set. You cannot use DATA-DISKS from different sets at the same 
time. Each of the DATA-DISKS must always be used in the same drive. 

Multiple DATA-DISKS must be backed up separately. 


Section 7: FOR HARD DISK USERS 


CONFIGURING 


Before using the Corvus hard disk drive, you need to read and follow the 
instructions in the Corvus manual for connecting the Corvus to your Apple. The 
only change is that the Corvus interface card should be installed in Slot 5. 
Slot six must contain the floppy disk drive interface card. 


Before configuring for the Corvus, be sure that the "write protect" label is 
removed from the SAVVY MASTER diskette. 

fa 
You need to decide how you are going to use the Corvus before entering eny 
numbers. SAVVY will allow you to use the entire Corvus (up to 20 megabytes) as 
one section, or you can divide it into sections and use different MASTER disks 
to bring up the different sections. 
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Use selection number 2 in the CONFIGURATOR MENU to change the MASTER disk in 
Drive 1 to the Corvus configuration. 


Press the RETURN in answer to the first two questions (Which CRT and which 
printer interface you are using) to bring you to the question about which drive 
you will be using. To use the Corvus, press the number 2. SAVVY then asks you 
for the beginning boundary. 


For this example we will set up a section of the Corvus using the boundaries 0 
and 1000. If you desire different boundaries, substitute your numbers for the 
ones shown in this section. For the beginning boundary, use the beginning of the 
Corvus. Press 0, then RETURN. SAVVY will ask how many K-bytes. In this example 
we are using 1000 k-bytes (1 megabyte). Enter 1000, hit RETURN. SAVVY will do a 
restart using the new configuration. 


If this is the first time you are using the Corvus with SAVVY, the first display 

will be the HELP MENU, because the hard disk does not have a "DATA-DISK" on it. 

It needs to be CLEANED first. Choose selection 2 of the HELP MENU to bring up 

the CONFIGURATOR MENU, and use selection 1 of the CONFIGURATOR MENU to clean the 

DATA-DISK. Once the DATA-DISK is cleaned, you will be shown the following: 
STARTUP (Undefined) 


What would you like me to do now? 


To copy one or more floppy disks to the Corvus, use the standby task ARCHIVE 
(refer to page number 6). 


If there is SAVVY data on the section of the Corvus that you are configuring, 
when SAVVY does the restart, it will do the task STARTUP. 


MAKING BACKUPS FOR THE CORVUS 


BACKUP 


To do a backup, press the letter B. The next message asks if you want to back up 
a Drive or a Physical drive. 


BACKUP A 
D(RIVE) OR P(HYSICAL DRIVE): 
À ten megabyte drive can be treated as two five megabyte drives or a twenty 
megabyte drive as two tens. A physical drive is just that, the whole drive. 


Start by making a backup of the physical drive. Press the P. 


The next message to appear is one asking you to enter the Drive number. It looks 
like this: 


ENTER THE CORVUS DRIVE NUMBER 


Since you are copying the entire physical drive, use the number 1. If you are 
copyiag half of a ten or twenty megabyte drive, then you could use drive l or 2. 
If you haven't done so already, type the number 1 or press the RETURN. There is 
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an automatic default to drive 1. You will next be shown the size of the o. C 
In this case, it will be 11220 blocks. 


You are then asked to enter the information that will appear on the image 
header. This consists of the time, date, an identifying name, and any additional 
comments. When you have entered all of this information, you screen should show: 


VER 4.3 
SAVVY BACKUP UTILITY 
14-May-82 
BACKUP A: 
ENTER THE CORVUS DRIVE NUMBER: 1 
SIZE OF BACKUP WILL BE 11220 BLOCKS 
ENTER DATE (DATE) 
ENTER TIME (TIME) 
ENTER NAME (NAME) 
ENTER COMMENT (COMMENT) 


POSITION RECORDER AND START RECORD 
PRESS <RETURN> WHEN READY... 


Start the record mode on the VCR; when you are sure that the tape is running, ~ 
press the RETURN key. The screen will add the message: I 


BACKUP STARTED... 


The backup process for a five megabyte drive takes approximately ten minutes. 
When it is finished, you will be shown: 


BACKUP FINISHED... 
ERROR STATUS 
DISK ERRORS: 
---ALL DATA STORED--- 


We recommend that you go through the backup procedure at least twice, to avoid 
the possibility of a bad spot on the VCR tape. 


IDENTIFY 


This process reads the image header that was recorded on the tape and displays 
it on the screen. It allows you to find the latest backup made, before putting 
it back on the Corvus. 

To do an IDENTIFY, press the l. The screen will show: f 


POSITION RECORDER AND START PLAYBACK 
PRESS RETURN WHEN READY 


After you press the RETURN, the following will be added to the screen: 
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SEARCHING FOR THE IMAGE HEADER 


The searching process runs for about 60 seconds. If the image header is found, 
it is displayed on the screen. If not, an error message is shown. For a further 
explanation of the error messages, refer to the chapter on the use of the 
Mirror(tm) in the Corvus Systems manual. 


VERIFY 


This option is similar to the option that restores the data, except this option 
does not write on the Corvus. It checks the information for errors, and 
indicates if a retry is needed. 


To use the VERIFY option, you press the V. The following message will appear on 
the screen: 


POSITION RECORDER AND START PLAYBACK 
PRESS <RETURN> WHEN READY 


When you have done that, you will see: 
VERIFY IN PROGRESS... 


The verify option takes about the same length of time as backup. When it comes 
to the end, you will receive a report of how many errors were encountered, and 
if you will need to may any retry passes when you do a restore. 


RESTORE 


This option puts the information back on the hard disk. Press the R and the 
following message appears on the screen: 


RESTORE A: 
D(RIVE) OR P(HYSICAL DRIVE) 
M(AN) 

Press the P. You are then asked: 


ENTER THE CORVUS DRIVE NUMBER 


Enter the drive number you are restoring, which will usually be 1۰ Once the 
option is in progress, the message: 


RESTORE IN PROGRESS... 


is added to the display. When RESTORE is complete, the screen will indicate that 
the data has been restored and how many blocks (if any) need a retry. To do a 
retry, rewind the VCR tape and run the RESTORE procedure again. 

QUIT 


Q will exit the program. 
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BEGINNERS' MANUAL 
FOREWORD 


Welcome to the world of SAVVY. You are about to start on an exciting 
adventure, programming in SAVVY. If you have little or no previous programming 
experience, don't worry. After completing this tutorial, you will feel 
comfortable handling many kinds of SAVVY programming jobs. If you are an 
experienced programmer in other languages, you will learn some new ways of 


thinking about programming and you will find yourself more efficient than you 
ever believed possible 


For the novice programmer: Follow the sections in this tutorial. Do all 
of the practice programming suggested, even if the programs aren't concerned 
with what you eventually hope to do. The practice will give you many insights 
and help you develop a feel for SAVVY's rhythm. 


For the experienced programmer: Read through the tutorial, try out any 


concepts that are unfamiliar to you. Do the section "Writing Your First 
Application". This will help you get the feel for SAVVY, and SAVVY commands and 
primaries. Appendix A is written with you in mind. 
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INTRODUCTION 


WHAT IS DIFFERENT ABOUT SAVVY 

SAVVY is a natural language programming language for microcomputers that 
is revolutionizing computer language standards. Ordinary programming languages 
consist of a set of symbols that represent various operations that the computer 
must perform. SAVVY does not use symbols. SAVVY commands are the same words as 
people use: ADD, DISPLAY, JUMP, REPEAT, COUNT, and so forth. 


All computer languages are able to handle conventional numerical and 
string manipulations and various input/output operations, but SAVVY has 
additional capabilities that go far beyond conventional languages. SAVVY can 
recognize things it has never seen before and can respond intelligently and 
correctly. To do this, SAVVY uses two unique features: “adaptive pattern 
recognition processing", and an "associative" ability. 


ADAPTIVE PATTERN RECOGNITION 

In formal terms, we may say that adaptive pattern recognition is the 
process of evaluating operator string input in terms of the pattern formed by 
the input string, searching the computer memory for a similar pattern, and 
executing the operations defined by the similar string. 


More simply, SAVVY looks at the pattern of letters or ¡etters and numbers 
you have entered. If these are different from something it already knows, SAVVY 
searches its memory to find anything that looks to be similar. These may be 
patterns of characters that it has learned through associations (see below), 
task names, variable names, primaries, or commands. If SAVVY finds a close 
match, it executes that matching string. If SAVVY finds several things that 
are similar, it lists these on the screen and gives you the option to select 
from the list. A "none of the above" choice is the last item on the list. If 
SAVVY can't find anything that looks like what you entered, it asks 
you to try again and reminds you of the types of entries it can handle in that 
particular situation. 


Adaptive Pattern Recognition Processing helps SAVVY deal easily with 
typographical errors, vague entries, and non-exact inquiries. In very exacting 


situations, pattern recognition can be turned off and, as SAVVY tells you, it 
"will make no assumptions". 


TEE ASSOCIATIVE ABILITY 


SAVVY's associative ability increases its power to interpret what it is 
being asked to do. By associating several synonyms to commaads, primaries, 
variable names, tasks, or to other associations, SAVVY can respond 
intelligently to many different instructions and do exactly what it is supposed 
to do. You can teach SAVVY to respond to the vocabulary you like to use, 
instead of your being required to memorize an arbitrary vocabulary established 
for some other situation. It is even possible to associate a complete set of 
foreign language words to SAVVY's existing vocabulary and to use those foreign 
words to instruct the computer. A SAVVY association can be up to thirty-two 
characters long, and can use letters, numbers, Spaces, and punctuation. 


VIRTUAL MEMORY 


SAVVY operates with a virtual memory system. This means that every task 
on a disk is available for use at all times, without the need to load a task 


BEGINNERS' MANUAL, INTRODUCTION (April 1, 1985) Page 3 


each time you want to use it. A library program can be written (to calculate a 
sine or alphabetize a data set, for example), stored on disk, and used 
independently or called from within a larger program as a subroutine. The 


contents of a variable are not lost as execution proceeds from one task to the 
next. 


EFFICIENT USE OF DISK SPACE 
All data is stored on the disk in a variable field length configuration, 
avoiding the wasted disk space situation accompanying most storage methods. 


NUMERIC CALCULATIONS 

SAVVY is a superb number-cruncher. All calculations are carried out to 63 
significant figures, while the format of the displayed or printed results can 
be specified. In addition, involved algebraic formulas are not used in SAVVY. 
Complex formulas are programmed as easy-to-follow sequences of arithmetic 
Operations (add, subtract, multiply, and divide). 


All arithmetic is "floating-point" arithmetic. Numbers of large and small 
magnitude can be used in the same calculation without modification. In 
addition, there is no need to define variables as integer, single precision, 
double precision, or string types. SAVVY is smart enough to do that for vou. 


STRING HANDLING 

The full range of string manipulation operations are available in SAVVY. 
First nahes, last names, and professional titles can be rearranged with ease or 
parts of strings can be separated for further manipulation. 


IMPORTANT THINGS TO REMEMBER 

SAVVY's ready message is "What would you like me to do now?". Whenever you 
see the ready message, you know that SAVVY is waiting for Instructions from 
you. You can tell SAVVY what you want it to do any time you see the ready 
message, and SAVVY will do it after you press RETURN. 


All of your instructions to SAVVY need to be in capital letters. Be sure 
the CAPS LOCK key is down. 


The escape key (ESC key) is used to stop whatever you are doing and give 
you the options to Finish, Resume, or Suspend. If you type in F for finish you 
will be taken back to the Ready Message. Suspend and Resume are explained in 
detail in the Reference section of this manual. 


NEVER! 

1) Turn off the power, or 

2) Remove the disk... 

until you have returned to the Ready Message. You can cause serious damage to 
the SAVVY disks that are in the machine. SAVVY uses high memory as an automatic 
cache memory for the work you are doing. All of this information must be 
restored to the disk before you leave SAVVY. That does not happen until you 
return to the Ready Message. 


SECTION 1 - THINKING ABOUT PROGRAMMING 


This manual is for people who have never programmed a computer before, as 
well as experienced programmers who want to use SAVVY to develop their own 
applications. As noted in the Foreword, how you use the material in the manual 
will depend on your experience, interests, and requirements. SAVVY can be used 
to write any computer program that you can write in other, more traditional 
computer programming languages, but SAVVY makes computer programming easier and 
faster. Programs written in SAVVY are usually simpler for others to understand 
and modify for their own unique situations. 


For those of you who have never programmed before, get ready for a 
pleasant experience. As you work with the material in this tutorial, you will 
find that developing your own programs for the computer is not as difficult or 
threatening as you may have thought. 


Once you start to learn the rhythm of SAVVY and a few simple programming 
concepts, you will begin to value the ability to create your own computer 
applications. You will be able to have the computer do exactly what you want it 
to do rather than what some writer of “canned programs" thought was desireable, 
on the average. You are freed from trying to explain what you need to a 
software salesman or an outside computer programmer. No matter how hard these 
outsiders try, they can't truly understand your job as well as you do. This 
means that when you spend time trying to explain what you need the computer to 
do to another person, some confusion is bound to arise. Valuable time and money 
are wasted trying to resolve these misconceptions. If you are your own program 
developer, you can avoid all these problems. 


If, on the other hand, you are doing program development for others, you 
will find the ease of writing and changing SAVVY programs a real benefit to you 
and your ciients. You save yourself time, you save your clients money, and you 
are free to be much more productive in more different areas. 


To begin to think about developing and writing computer programs, there 
are several things you need to think about before you start entering 
instructions into the computer. 


EVALUATE THE PROBLEM: 

First, you need to analyze the problem you are addressing. Some problems 
are more amenable to computer solution than are others. Computers are good at 
dealing with lots of numbers, a mass of text information, or both. Ask yourself 
what is the final product you want the computer to produce. If the answer is 
keeping track of records for three employees, finding 20 of your favorite 
recipes, or once a year figuring how much interest you have paid on a single 


loan, it is not worth putting into the computer, except for the programming 
practice. 


If the answer is keeping accurate records for 100 students, getting 
information on all the books in your library, preparing a list of all the 
records in a radio station that had Chet Atkins as a member of the band, or 
preparing a payroll for 25 employees, then computerizing the job is worth 
while. 


IDENTIFY THE STEPS TOWARD A SOLUTION: 


Once you have decided that your problem is worth computerizing, and you 
have identified the end product you want the computer to produce, you are ready 
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to divide the problem into its appropriate parts. No matter how smart a ^ 
computer is, it will still have to be told how to do each of the steps needed 

to produce the end result. You will need to figure out what each step of the 
process is and where it goes before you can start to instruct the computer. It 

is helpful to write these steps down on a piece of paper so you can study them. 
For example, if you are thirsty and want a drink of water, what do you do? 


Get a glass 
Fill it with water 
Drink it 


Are these really all of the things you have to do, or are there more? Think 
about the problem again. 


Find a glass 

Pick it up 

Carry it to where the water faucet is located 

Turn on the water 

Put the glass under the water 

Let the water rise in the glass 

Remove the glass from under the water 

Put your hand on the faucet 

Turn off the water 

Lift the glass to your mouth 

Swallow the water x 
Look at the steps again. Are they all there, or is something still missing. How  - 
did the water get turned on? Didn't you extend your arm, tighten your fingers, 
rotate your wrist? Now you begin to get the idea of breaking a problem down 
into the various parts. 


WRITE THE PROGRAM 

Now you are ready to tell the computer what to do. You do this by typing 
the right commands into the computer in the proper order. Right now, don't 
worry about what these commands are, you will get plenty of practice later on. 


TEST AND DEBUG YOUR WORK 

When the computer program is written, you need to be sure it runs the way 
you want it to. To do this, you type in a little bit of all the kinds of 
information that particular program is supposed to be able to handle. Watch to 
see if the computer really gives you the product you had in mind at the 
beginning. If it does, the program must be o.k. If it doesn't, go back and 
check the program to see if you used all of the right commands in the right 
order. If the commands and sequence look right, go back to your pencil and 
paper outline and see what other steps you need to include or what other order 
you might use to accomplish the job. Now, change what needs to be changed in 
the computer program and test it again. Once your program runs right, you are 
ready to move on to the next job. 


This may sound like a complicated process, but once you get involved in 
really doing it, it can be a lot of fun. 
=> 
At this point, its time to learn some serious computing terms. These terms 


refer to the different steps in developing a computer program as discussed 
above. 
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Systems Analysis - When you do a systems analysis, you determine what 
the problem is and what needs to be done to solve it. The total solution to the 
problem includes more than just the computer and the programs that need to be 
developed. A complete systems analysis includes all of the things that must be 
done by man and machine alike to get the problem resolved 


As a simple example, think of preparing a notice that needs to be read by 
100 different people at about the same time. First, you need to decide exactly 
what information needs to be in the notice. Next, you need to know how the 
information should be worded and who will write it. You need to decide how the 
notice will get to all 100 people at about the same time. Depending on the 
answer to the last question, you need to decide on the best way to produce the 
notice and finally on the exact way to distribute it. These answers raise a few 
new questions. Who will be responsible for producing the notice and who will 
distribute it? If you have decided to use a computer for the job, you need to 
know if the programs are available. If they are, fine; if not, who will write 
them and what do the programs need to do? 


This process could be carried further, to a final answer for every 
possible question and an integrated approach to the solution. You can see that 
a complete systems analysis can lead you to think of details that you 
overlooked on your first perusal of the problem. A good systems analysis takes 
time in the beginning, but ultimately saves much time and insures a better 
solution in the end. 


Output - Output is the term applied to the information the computer is 
going to produce when it has done its job. It is analogous to the final product 
mentioned earlier. The computer will give you whatever information you tell it 
to give you, once you have taught it how to think about the information. Be 
sure you teach it what you really want it to know. 


Input - Input is the term used for the information you are going to 
teach, or enter, into the computer. The computer is going to use this input in 
producing the output. The quality of the information you put in (input) is 
going to govern the quality of the product (output) you receive back. 


Process - Process refers to the steps or actions the computer will 
perform in order to turn the information (input) you entered into the product 
(output) that you want back. These steps are contained in the set of 
instructions or computer programs that you developed for a particular problem. 
When the computer receives input, it processes the input and gives you output. 
This is analogous to making a cheese dip. You put the cheese and the other 
ingredients (input) into a blender, process them, and get cheese dip as output. 


Coding - Coding is the actual entry of the computer program into the 
machine. This is where you tell the computer exactly how it is to handle or 
process the information you give it to return the product you need. You also 
should tell the computer where it is to send the output. Do you want to read it 
from the computer screen or do you want it to appear on a printer? If you 
forget to tell the computer to either display or print the output, the computer 
will have all the answers, but you won't be able to see what they are. Š 


Testing - When you test the programs you have written, you enter samples 
of information or data of the kind you intend to use for the finished product. 
You then examine the output to be sure the program is doing exactly what you 
want it to do. Testing is a very important part of programming. It is a good 
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idea to test different parts of the overall program as you go, to be sure each 
part is working properly. If you wait to test until the program is completed, 
it is much more difficult to find any errors you may have made. 


- Operating System - SAVVY comes with its own operating system. The 
operating system is the computer's internal manager. It controls the flow of 
information and commands between the CPU (Central Processing Unit) in the 
computer and the computer's accessories, such as the RAM (Random Access 
Memory), CRT (Cathode Ray Tube - the screen), printer, disk drives, and other 
peripheral equipment. For example, the operating system controls the computer's 
work during the process of making backup (duplicate) copies of the information 
stored on the disks; the computer reads the information from the "source" disk 
into the internal memory and writes it from the memory to a second, or 
"destination" disk, and then erases the internal memory to make it ready for a 
new batch of information. The operating system also manages the way the 
information is stored on the disk. 


Editor - SAVVY has a built-in editor. The editor is a group of programs 
that lets you write and change the programs you have entered into the computer. 
The editor lets you list a program so you can see exactly how it is written 
(what commands it contains). It lets you add new code or instructions to any 
part of a program. It lets you delete unwanted lines of code from the program. 
Finally, the editor lets you change a line of code that you have previously 
written. An efficient editor is an important programming side. 


This vocabulary is a necessary part of computing. With these terms, and 
others that you will learn as you go along, it is possible to communicate 
precisely with others as you describe and discuss your discoveries, adventures, 
and problems as you progress toward mastery of SAVVY. 


SECTION II - GETTING STARTED 


You have learned how to make backup disks and start up (boot) your SAVVY 


system in the Introduction to this manual. You are now ready to start with a 
clean data disk. 


If you are using SAVVY One, just make a backup of your SAVVY One Master 
and you are ready to start. If you are using SAVVY Two, put your Master in 
Drive 1 and a blank disk in Drive 2. SAVVY will inform you that it was 
expecting a good data disk and then display several options. You want to use 
option 2, Congifurator. When the Configurator menu is displayed, you want 
Option 1 - Make a clean data disk. Follow the instructions on the screen by 
typing in the appropriate responses and pressing RETURN. SAVVY will format your 
data disk and copy all needed information. When you see the "What would you 
like me do do now?" message, ycu are ready to start. 


SAVVY Dictionary: SAVVY comes from the factory with a limited 
knowledge of English words. When SAVVY sees each of these words, it knows that 
it is supposed to do a particular thing. As you work with SAVVY, you will be 
teaching it new words. It will understand that each new word or group of words 
instructs it to perform specific jobs that you will have defined. 


The words that SAVVY has learned at the factory are kept in its 
Dictionary. When you teach SAVVY new words, these are also stored in the 
Dictionary. SAVVY uses its Dictionary to look up the meaning of each word you 
enter. If it knows the word, it knows what to do. If it doesn't know the word 
it will respond with the message: 


"I was expecting a _, but (new word) is something new to me. Would you 
please try again." 


SAVVY helps you know what it does or doesn't understand. To see what is in 
SAVVY's Dictionary, type in: 


LIST (press RETURN) INDEX (press RETURN) DICTIONARY (press RETURN). The 
screen will display: 


"List the INDEX of the file called DICTIONARY." 


SAVVY will then start an alphabetical list of all of the words it knows. 
To stop listing the dictionary at any point, press the ESC key. 


To see specific kinds of information stored in SAVVY'S dictionary, you 
can: 


LIST the TASKS 


This will show you an alphabetical listing of all of the TASKS and FUNCTIONS 
SAVVY knows. 
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LIST the ITEMS 
This will show you an alphabetical list of all of the ITEM names SAVVY knows. 


LIST the FILES 


This will show you an alphabetical list of all of the FIJLE names SAVVY knows. 


The FREE and LITERAL Modes: SAVVY uses two different ways to think 
about things, FREE and LITERAL. 


` “In the FREE mode, SAVVY uses pattern recognition to figure out what you 
mean even if you don't enter the words exactly right. As SAVVY tells you, 
SAVVY will use its best judgement to figure out what you mean. 


In the LITERAL mode, pattern recognition is turned off and SAVVY expects 
every entry to be exact. SAVVY makes no assumptions. This can be very handy 
when you are Programming, as you will see later. 


When you first enter the SAVVY environment, you are always in the FREE 
mode, 


ESC-F: In the Introduction, you learned about the Escape key (ESC) and 
the F key. Remember you can use these at any time while you are working in the 
SAVVY environment. Just one word of caution: If you are writing or editing a 
Program and use the Escape key, SAVVY will not save the work you have just 
done. You must complete the Proper editing sequence for SAVVY to remember the 
new things you have taught it. The sequence is explained in the "Editing" 
section of this tutorial. 


Telling SAVVY What to Do: Wherever you are in the SAVVY enviroament, 
all of your entries must be in capital letters. SAVVY fills in other words in 
lower case letters to make each line or statement more complete and easier to 
understand. 


The bes: way to see how this works is to ERK 2 Assuming that your 
computer is turned on and you have a clean Data Disk to work with, type in: 


DIVIDE (press RETURN) 

The screen displays: DIVIDE the _ 

The cursor will show after the blank. Enter a number you want to divide: 
DIVIDE the 777 (press return) by... 


You can see where the number you entered is and that the cursor has moved 
to a new blank. Now enter the number you want to divide by: 


DIVIDE the 777 by 7 (press return) 
SAVVY has completed the operation and now knows what the answer is, but 
you can't see it yet. You need to tell SAVVY you want to know the answer. 


There are a several ways to do this that SAVVY understands. 


Try this first: 
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Type in: SHOW (press RETURN) 

You see: SHOW the _ 
Now type in: QUOTIENT (press RETURN) 
SAVVY will respond: QUOTIENT is 111 


Here is another approach. Type in: DISPLAY (press RETURN) 


You see: DISPLAY the _ 


Now type in: QUOTIENT (press RETURN) 
SAVVY will respond: 111 


Here is a third approach that is a little more sophisticated. Type in: 
COPY (press RETURN) 


You see: COPY from _ 

Next, type in: QUOTIENT (press RETURN) 
You see: COPY from QUOTIENT to _ 

Type in: ANSWER (press RETURN) 

You see: COPY the QUOTIENT to ANSWER 
Now type in: SHOW (press RETURN) 

You see: SHOW the _ 

Finally, type in: ANSWER (press RETURN) 
SAVVY will respond: ANSWER is 111 


You should begin to get the feeling of when to press RETURN. Each time 
you give a single instruction to SAVVY you press RETURN. If SAVVY needs more 
entries to complete the operation, it prompts you for these. Each entry is a 
separate instruction as far as SAVVY is concerned. 


If SAVVY needs no more information, it will perform the operation. Here 
are some other operations for you to practice. In each case what is typed in 
capital letters or is a number needs to be entered before anything else will 
happen. See if you can figure out where to press RETURN for each example. 


ADD the 123456789 and 001 

SHOW the SUM 

RING bell 

CLEAR the page 

COPY from 1111.2222 to ANSWER 

SPLIT the number ANSWER 

SHOW the FRACTION 

SHOW the INTEGER 

PASTE the "JOHN in front of ",SMITH 
SHOW the FRONT 


NOTE: When you are entering any information where SAVVY does not need to 
know the exact meaning of that information, you need to begin the entry with a 


quotation mark ("). SAVVY will automatically supply the ending quote when you 
press RETURN. 


What is a SYSTEM COMMAND: A system command is exactly what it says it 
is. It tells the SAVVY system to do a particular thing. If you use the system 


command FREE, it tells SAVVY to use pattern recognition at all times until it 
is told otherwise. 
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The system command DEFINE tells SAVVY that you are getting ready to write 
a new program. When you give the program a name and press RETURN, SAVVY 
automatically reserves a place on the disk for the program and adds the name of 
the program to its dictionary. Once the program is DEFINED, it never needs to 
be defined again because SAVVY remembers. 

The "SUMMON the standby task" command tells SAVVY to save everything it 
has been working with onto the disk and return to the STANDBY TASKS 

There are several other system commands and you will learn these as you 
go. They are all given in the Reference section of this manual. 


What is a Command: A command tells SAVVY what to do. Commands are 
usually used within programs to tell SAVVY what you want it to do in a 
particular place. Commands can be thought of as part of the actual programming 
language. You have already used a few commands when you were practicing with 
SAVVY earlier. Examples of these commands are:  DIVIDE, SHOW, DISPLAY, COPY, 
ADD, RING, CLEAR, SPLIT, and PASTE. 


SAVVY has many different commands. Some are more geuerally used in 
programming than others. This tutorial concentrates on the most frequently 
used commands. Once you have practiced enough to be comfortable with these, 
you can branch out to use others. 


What is an Item: An item is used to store specific information. The 
information may be words or numbers. In the earlier practice session you 
stored a number in the items QUOTIENT, ANSWER and SUM. These are standa-d 
items that SAVVY learns at the factory. You will learn how to add more items 
to SAVVY's dictionary as you go. SAVVY remembers what was stored in an item 
until you tell it to store something new in that same item. This can be very 
helpful in programming. Items can be thought of as variables or variable 
names. 


What is a Task: SAVVY uses the term TASK to refer to an independent 
part of a program. TASK is a series of related instructions to the computer 
that tell the computer how to perform some specific operation. TASKS are 
composed of commands and other TASK names. These TASK names can act as 
programming commands, too. 


To see how all of this works, type in the following TASK. Remember to 
press RETURN after each instruction you give to SAVVY. To help you out, each 
command or string you are to type in is underlined. Press RETURN after each 
underlined section. 


DEFINE a task called HELLO 


NOTE: If you make a typing mistake, just use the left-pointing arrow key to 
back up and correct it. If you enter scmething that SAVVY doesn't understand 
and it asks you to try again, check your spelling and try again. Tf you really 
mess up and get stuck, press ESC-Q and wait until you get to the section on 
editing. 


The screen will display: 0 --- Task HELLO 
Type in the following; SAVVY will automatically number the lines for you. 


DISPLAY the "WHAT IS YOUR FIRST NAME. TYPE IT FOR ME. 
CARRIAGE return 
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INPUT into ANSWER 
CLEAR the page 
DISPLAY the "HELLO 
DISPLAY the ANSWER 


Q 


Now try the task to see if it does what it should. To do this just type in the 


task name 


Type 


HELLO and press RETURN. The screen should then display: 
WHAT IS YOUR FIRST NAME. TYPE IT IN FOR ME. 
in your first name. The screen should clear and then display: 


HELLO, (whatever name you typed in) 


You will then be returned to the Ready Message. 


You are ready to DEFINE a new task. 


Type 


in: DEFINE a task called TRY ME 


The screen will display: 0 --- Task TRY ME 


Now type in the following commands: 


1 Does HELLO 

2 and CARRIAGE return 

3 and PROMPT for LAST NAME 

(respond by pressing Y when SAVVY asks "Should I make it an 

Item?") 

and CLEAR the page 

and CURSOR to line 15 and column 35 

and DISPLAY the LAST NAME 

and RING bell 

and Q 


00 dd o n ج‎ 


You have just used a task name within another task to create a new effect. 


First try 
tried it. 
thing you 


Then 


Next 


HELLO again to see if it works the way it did the last time you 
You see, it did. Now type in TRY ME and press return. The first 
should see on the screen is: 

WHAT IS YOUR FIRST NAME. TYPE IT IN FOR ME, 

you see: 

HELLO, (whatever name you typed in) 


you see: 


LAST NAME 


After you type in your last name and press enter you should see your last 
name displayed in the middle of the screen and hear the computer ring a bell. 
Then SAVVY will display the Ready Message again, You will use these tasks 
again when you start to practice with the editor. 
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If you were to go back and LIST the INDEX of the file called DICTIONARY 
you would now find two new entries, HELLO and TRY ME. Each time you DEFINE a 
task, that task name is automatically added to SAVVY's dictionary and will stay 
there unless you RENAME the task. To RENAME a task, you simply type in RENAME. 


The screen will display: RENAME old name 
Type in: HELLO 
You will see: RENAME old name HELLO to new name 


Now type in: HI THERE 


Try typing in HI THERE once you are at the Ready Message again. After you 
press enter, you will see that the new HI THERE is still the old HELLO task. 


How did SAVVY deal with HELLO in the task TRY ME? Type in TRY ME to see 
if it still works the way it did before. What do you know! SAVVY is pretty 


clever! When you work with the editor you will get a chance to see what SAVVY 
did. 


What is a File: A file is like a manila file folder. It is a place to 
store information that you could store on a form in an ordinary file folder. 
If you pulled out a folder marked "Payroll Time Sheets" you would expect that 
each sheet would ask for the same kinds of information and that each sheet 
would be filled out with the appropriate information for each employee. These 
are the same kinds of sheets that can be stored in a computer file. Computer 
files contain records. A record in computer terms is the same as an individual 
form or sheet that is contained in the manila file folder. Each record 
contains many kinds of information about a single person, thing, or event. 


A data base is a large collection of many folders or files. Each file 
contains the same kinds of forms or records. A data base lets you easily sort 
through and extract information about several different subjects. You could 
have an employee information file, a payroll time sheet file and a customer 
file. You could then get information from any of these files in much the same 
way you would the manila folders. The difference is, in a data base, you tell 
the computer what you are looking for and the computer searches until it finds 
it. If you have a lot of information you look through regularly, it is much 
faster to use a computerized data base than the original file folders. 


When you CREATE a file in SAVVY, you need to do three things: First you 
select a name for the file. It is always a good idea to select a name that 
makes sense to you or whomever is going to be using the files. 


Second, you must tell SAVVY what classes of information you are going to 
want to look at and in what order you want the information or records saved in 
the file. 


Third, you need to tell SAVVY all of the types of information you want to 
see when you look at the records in each file. Here is a file called MY 
FRIENDS. Each friend can be found by name. You know the names of your 
friends, but you may not remember other items of information about all of your 
friends. These are the items you want to be able to find in the computer. 
This is what a form, or record, in this file might look like: 
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MY FRIENDS 
ID NAME 
item ADDRESS 
item PHONE 
item BIRTHDAY 


Now, once you have entered information about your friends, you could easily 
find John Jones' address or Mary May's birthday. 


SAVVY has many commands that let you manage the information in these files 
like ADD, SAVE, REPLACE, or DELETE records in a file. When you reach the 
section that has you create applications, you will get to practice using files 
and records. 


What is a Function: A function is another way you can create your own 
programming commands in SAVVY. Using FUNCTION you can create commands that 
prompt for specific information. A function can prompt for from one to nine 
different pieces of information. The information may be either words or 


numbers. You have seen how the SAVVY command ADD prompts you for certain 
information; a, FUNCTION is much the same. 


Suppose you want to write a program that prints asterisks (*) at certain 
places on the screen. Let's say that you choose to have an asterisk on line 5, 
at the 16th column from the left. In SAVVY, there is a command CURSOR that is 
used to specify the location of the next character that is displayed. It 
involves several line of programming: 


CURSOR to line 5 and character 16 
DISPLAY the "x" 


That works well, but what if you want to display 20 asterisks at 20 different 
places? That a lot of typing. It would be easier to write a special little 
program that would do the work for us; all we'd have to do is enter the 
variable values. Such a program would be a function. Let's begin to write a 
function. 


In ordinary English words, we might describe the command as "At line 5, 
character 16, display "*", Let's use that as the command line for our new 
function, giving the function the name that is the first word in the command 
line: "AT". Before you start, there are several points to remember: 


1. A FUNCTION is just a task that prompts you to enter the values of one 
or more variables (remember? a variable is an object whose value varies). 


2. A variable is called an "argument" when writing a function. 


3. The function line consists of prompts and argument numbers. 
Here is a useful function you can try yourself. 


4. A function is usually used within a bigger task. 


5. An argument can be a numeric value or a string of characters (strings 
values are identified by being enclosed in quotation marks). 


The line "AT line 5 character 16 display "*"" can be broken down into: 
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AT (the function name, used to call it up as if it were a SAVVY command) 
line (prompt for argument 1) 

<1> (argument 1) 

character (prompt for argument 2) 

<2> (argument 2) 

display (prompt for argument 3) 

<3> (argument 3) 


So let's do it: 


To start, type in: FUNCTION 

You see: FUNCTION called 

Type in: AT 

You see: FUNCTION called AT 
Number of arguments (1-9): 

Type in: 3 

You see: prompt for <l> is 

Type in: LINE 

You see: prompt for <2> is 

Type in: CHARACTER 

You see: prompt for <3> is 

Type in: DISPLAY 


Now the screen displays: 
FUNCTION AT line <1> character <2> display <3> 
You see the cursor blinking. 


Type in the command: CURSOR 

You see: CURSOR to line 3 

Type in: <1> 

You see: CURSOR to line <1> and character 
Type in: «2» ۳ 
Now you see: 1 Does CURSOR to line <1> and column <2> 
Type in: DISPLAY 

You see: DISPLAY the 

Type in: <3> 

You will see: DISPLAY the <3> 

Type in: Q 


Now you have your own function that you will be able to use when you get 
to the section on editing. The function name is saved in SAVVY's dictionary. 
You can use it like any other programming command. 


When selecting names for items, tasks, files, or functions, try to pick a 
name that makes sense to you. It doesn't matter how long this name is or if it 
has spaces between the words, SAVVY can handle both. You can use numbers in 
these names if they make sense to you, too. If you pick a name that is long 
because it is logical and later get tired of all of the typing, there is a way 
around this that you will learn in another section. 


What is a Program: In SAVVY terms, a program is a collection of tasks, 
commands, items, and files that are combined to accomplish a specific 
objective. A program knows how to take the information you enter (input), 
process it in the correct way to give you new information (output) that solves 
a particular problem. The problem need not be mathematical. Computers have 
gained the reputation of being "number crunchers" because they can handle 


“y 
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numbers very quickly and accurately. They are better defined as information 
processors because they can handle words as well as number. Asking the 
computer to figure the interest on a loan is a number problem, but asking the 
computer what kind of clothes you should take on a June trip to New Zealand is 
a word problem. Savvy can handle both equally well. 


Here are two examples of SAVVY tasks that qualify as programs because they 
use some combination of commands, functions, items, tasks, and files to process 
information: 

1) 0 --- PROCESS LOANS (A task) 
1 START a loop 
2 DISPLAY THE LOAN MENU 
3 ASK FOR CHOICE up to a maximum of 5 
4 IF the CHOICE .. IS .. "O" 
5 LEAVE this look 
6 END of test 
7 TAKE REQUESTED LOAN ACTION 
8 REPEAT this loop 
9 CLEAR the page 
2) 0 --- WHAT TO WEAR (A task) 

1 START A LOOP 

š DISPLAY THE WEATHER MENU 

3 ASK FOR CHOICE up to a maximum of 4 
4 IF the CHOICE .. IS .. "NONE" then 
5 LEAVE this loop 

6 END of test 

7 DISPLAY THE PLACE NAMES 

8 REPEAT this loop 

9 CLEAR the page 


AA y 
1 ۸ l H u 


ie M 


mM Akas ec 


senam a 


A! ۱ 
اب‎ 


aut 

"(e 
2۷ ۱ | M 5 
n ۱ OA y ۷ A 
AS AS 


n IM 


Ho Y 


ñ [ab T ۲ 
"erm =; m^ و‎ (nme 
dea ER CRA 


SECTION III - USING THE EDITOR 


The SAVVY editor lets you DEFINE and write a new task. It also lets you 


move 


around freely within a task you have already written to make changes, 


additions and deletions. The SAVVY editor is simple and straightforward to 


use, 


but like everything else, it takes a little practice to feel confident 


about what you are doing. Most of the editing commands are single keystroke 
commands that allow you to move the cursor to different lines and parts of a 
task, and add or delete complete task lines. 


each 


will 


just 


Below is a list of all of the editing commands and a description of what 
commands does: 


EDIT the (task or function name) 


This puts you in the editing mode. Once you have entered the 
command you will see the name of the task on the screen. 


The L command gives a complete program listing on the screen. 


The Right Pointing Arrow key 


Deletes everything you entered on a line since you last pressed the 
RETURN key. 


The Left Pointing Arrow key 
Moves you one character to the left. 


Any Number 
Will move you to that specific line number within the program 
listing. 

D 


Will delete the line directly above the cursor 
position. 


To add a new line to the end of the program, just type the line in. SAVVY 
take care of the rest. 


To add a new line in the middle of the program, type in the line number 
above where you want the new line. This moves the cursor to the desired 


position. After you have added the new line, SAVVY will automatically renumber 
all of the lines for you. 


To leave the editor and save all of the changes you have made, type Q. 


To leave the editor without saving the changes you have made, press the 


ESC key and F (ESC-F). 
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Now you are ready to practice editing. Remember the task you entered 
called TRY ME? Type in: 


EDIT the TRY ME 
The screen will display: TRY ME (a task) 
Then press: L 


You will see a complete task listing on the screen. Notice the commands 
CURSOR and DISPLAY. These commands are the same commands you used when you 
wrote the function AT. Why not substitute one line of programming for two? 


Move the cursor just below the line that says DISPLAY. Type D. The line 
is gone. Now the cursor should be right under the line that says CURSOR. Type 
D. That line is gone, too. You need to give the computer the new instructions 
now. So type in AT, then 15, then 35, LAST NAME. All you need to do now is 
type Q. The changes you made are saved. Now it is time to test the task to see 
if it works the way it did before you edited it. Type in TRY ME. The task 
should run exactly the same. 


Now, EDIT the TRY ME again. Move the cursor just under the first line and 
type D to delete the first line that says: HELLO. Type Q. Now type in TRY ME 
again and see what happens. 


The first part of the task is no longer there. You could restore TRY ME 
to its original form by editing it again and inserting HELLO at the top by 
typing in 0 and then HELLO, or you could DEFINE a new task. To see how you can 
put tasks together to make new tasks, try the second option. 


Type in: DEFINE the TRY AGAIN 
You will see: 0 --- Task TRY AGAIN 
Now type in: HELLO 

Next type in: TRY ME 


Your task should look like this: 
TRY AGAIN (a task) 


] HELLO 
2 TRY ME 


Type in Q to save this new task, then test it by typing 
in: 


TRY AGAIN 


It should look just like your original TRY ME. 


Here is one more experiment to try before you get into some serious 
editing practice. DEFINE another task called THIRD TRY. 


You will see: THIRD TRY (a task) 
Now type in: TRY ME 

Next, type in: HELLO 

Then Q to exit the editor. 


What do you think will happen when you type in THIRD TRY? Try it and see. 
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Now for some serious practice with the editor. The first thing you are 
going to do is DEFINE a new task and enter all of the commands needed. Then 
you will practice moving around in the task using different editing techniques. 

Remember that each entry that is underlined is for you to type in and then 
press enter. SAVVY will fill in all of the line numbers and provide the ending 
quotation mark. 


DEFINE the EDITING PRACTICE 


1 DISPLAY the "Q RETURNS YOU TO THE READY MESSAGE 

z CARRIAGE return 

3 DISPLAY the "L GIVES YOU THE PROGRAM LISTING 

4 CARRIAGE return 

5 DISPLAY the "THE RIGHT ARROW DELETES ALL YOU HAVE TYPED SINCE LAST 
PRESSING RETURN. 

6 CARRIAGE return E 

7 DISPLAY the "LEFT ARROW MOVES YOU ONE CHARACTER TO THE LEFT. 

8 CARRIAGE return 

9 DISPLAY the 'A NUMBER WILL MOVE YOU TO A SPECIFIED LINE 
NUMBER IN THE TASK. 

10 CARRIAGE return 

ET DISPLAY the "D WILL DELETE THE LINE ABOVE THE CURSOR. 

12 CARRIAGE return 

L3 DISPLAY the "THIS LINE IS FOR YOU TO DELETE 

14 CARRIAGE return 

15 DISPLAY the "YCU ADD A NEW LINE BY TYPING IN A COMMAND 

LIKE DIVIDE 

16 CARRIAGE return 

17 DISPLAY the "YOU CAN USE ESC KEY TO ESCAPE IF YOU GET 


18 CARRIAGE return 
19 DISPLAY the "TO CHANGE A LINE YOU MUST TYPE IT IN AGAIN AND DELETE THE OLD 


20 CARRIAGE return 

21 DISPLAY the "CHANGE THE XXX IN THIS LINE TO CAT. 
22 CARRIAGE return 

23 DISPLAY the "HERE IS ANOTHER LINE TO DELETE. 

24 RING bell 


Q 


Now that you have entered the task and exited the editor, type EDITING 
PRACTICE. Read the screen display to see how it looks. Does it look the way 
you expected it to? 


It is time to work on editing the task. Type in: 
EDIT the EDITING PRACTICE 
Do each editing operation in the order listed below. 


We will now go through the commands one at a time. 
Type L to list the task 

Type 10 to see the first 10 Lines of the task. 
Type 0 to get above the first line of the task 
Type L to list the task again. 

Type 26, the D to delete this line. 


سا N‏ یں جم ما 
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6 Type 
cat 

a Type 
8 Type 
9 

10 Type 
11 Type 
12 Type 
13 Type 


24, then type in everything in the task line so you can change xxx 


24, then D to delete the original line. 
16, and delete line 16. 


Delete line 10. Now you can add some lines. 


14 to start adding below line 14. 

in MULTIPLY, then press RETURN. 

in 99 and press RETURN. 

in 5 and press RETURN. Your screen should look like this: 
15 and MULTIPLY the 99 by 5 


14 Now type in SHOW and press RETURN. 


15 Type 
16 Type 
17 Type 
18 Type 

Now, 


19 Type 
20 Type 


in PRODUCT and press RETURN. 

L to list the program. 

RING and press RETURN. 

RING and press RETURN 

to leave the editor: 

Q and press RETURN 

in EDITING PRACTICE and see how your task has changed. 


to 


21 To practice more editing, type in EDIT, then press RETURN and type EDITING 


PRACTICE. 


Try the commands out and when you are ready to quit 
editing, then type Q and press RETURN. 


Use the editing commands by changing things in the task. Feel free to 
change anything you want because you know you can always edit the task back to 
the original version. When you feel you have practiced enough, leave the 
editing mode by typing Q. The more editing you do, the more automatic the 
commands will become. 


SECTION IV - WRITING YOUR FIRST SERIOUS PROGRAM 


You have developed and written some SAVVY tasks and programs that 
illustrate SAVVY's flexibility and ease of use. Now it's time to write a 
serious program. The example here is how to let SAVVY figure the area of a 
"right triangle" (A triangle with a 90%, or right, angle at one corner). You 
non-mathematical types take heart, this is not higher math, and the principle 
to be illustrated is valuable for all kinds of work. 

Before you start to enter the commands, you need to know the formula you 
will be working from. In this case, the formula can be expressed in words: "To 
get the area of a right triangle, with the 90° corner at one end of the 
bottom of the triangle, multiply the width of the base of the triangle by the 
height, and divide the product by 2". In mathematical terms, the formula will 
be: A=(BxH)/2. This is as mathematical as we'll ever get. 


When you reduce it to individual steps, you get this flowchart: 


Tell the machine the width of the base. 
Tell the machine the height. 

Multiply those figures together. 

Divide them by two. 

Display the answer on the screen. 


By the way, don't look in this section for a weighty compilation of the 
commands you're going to use. There isn't one. Part of SAVVY's power is that 
the commands are natural language words. As you use them in the following 
paragraphs, the meaning of each command will be self-evident. 


To proceed: DEFINE a task called “AREA OF RT TRIANGLE BY TASK", and let's get 
started. 


Enter appropriate commands for the flowchart above: 


0 --- AREA OF RT TRIANGLE BY TASK (A task) 

1 Does INPUT into BASE 
Note: The machine doesn't know BASE. It will ask 
you if it should make it an item? Tell it "Y", 

2 and INPUT into HEIGHT 
Note: It doen't know HEIGHT, either. 


3 and MULTIPLY the BASE by HEIGHT 
4 and DIVIDE the PRODUCT by 2 

5 and DISPLAY the QUOTIENT 

6 and Q 
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Run the program. At "What do you want ...", type in the name of your task. The 


cursor will stop. Type in a 2 and press RETURN. The cursor stops again. Type in. 


another 2. Press RETURN again. The machine prints a third two on the screen. 


What's happening here? Well, SAVVY waited for your input, it got it, it waited 


for some more input, it got it, and then it displayed (2 x 2)/2, or 2. The task 


worked, but it wasn't very satisfying, was it? It lacked elegance. 


Let's clean it up: First, the numbers on the screen were all jammed together on 


one line. We can separate them by adding the CARRIAGE (return) command after 
each instruction that results in a video display. In other words, after the 
INPUT statements (statement is computerese for "command"). 


To do this, go back and review the "editing commands". To get into the EDIT 
mode, we have to type in 


EDIT the (task name goes here) 


The screen shows the task name, the number 0, and a blinking cursor. Press L. 
The task is displayed. Read it over, and decide where you want the CARRIAGE 
return line. In this program, let's put it after line l. Press 1, and then 
ENTER. You get: 


O --- AREA OF A RIGHT TRIANGLE BY TASK METHOD (A Task) 
1 Does INPUT into BASE 
2 and 


Type in CARRIAGE and press ENTER. Now line 2 looks like: 
2 and CARRIAGE return 

and you see "3 " and the cursor. 

Press L 


Now, your progran includes the CARRIAGE return line and all the succeeding 
lines have been renumbered. Here's what you should see: 


---.AREA OF RT TRIANGLE BY TASK (A task) 
Does INPUT into BASE 

and CARRIAGE return 

and INPUT into HEIGHT 

and MULTIPLY the BASE times the HEIGHT 
and DIVIDE the PRODUCT by the 2 

and DISPLAY the QUOTIENT 

and Q 


O‏ س دہ Q‏ ج مان ی 


It's almost magic! 


Press Q to get out of the EDIT mode and run your program again, the same way 
you did above. Do it now. You see that your second input went on a new line, 


below the first input, but the last 2 (the QUOTIENT) is still on the same line 


as your second input. Another CARRIAGE return will take care of that, so put 


another CARRIAGE return after line 3, using the editing procedure you used to 
put in the first one. 


= 


4 


EF 
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After you've done it, run your program again. You're making progress. 
Here's where you should be, now: 


--- AREA OF RT TRIANGLE BY TASK (A task) 
Does INPUT into BASE 

and CARRIAGE return 

and INPUT into HEIGHT 

and CARRIAGE return 

and MULTIPLY the BASE times the HEIGHT 
and DIVIDE the PRODUCT by the 2 

and DISPLAY the QUOTIENT 

and Q 


00 ي ی‎ Q + Co lo O 


Continue to clean up your program. Go back to the EDIT mode (EDIT the AREA OF 
RT TRIANGLE BY TASK). 


In line 0, type CLEAR, press enter. Run your program again. A.l the extraneous 
information is now gone, and you have only your input numbers and the result on 
the screen. It's rather bare and uninformative like that, so it's time to put 
some explanatory text on the screen. Modify your task untii it looks like the 
listing below: 


NOTE: Don't forget that as you enter the additional lines, you can go out of 
the edit mode any time you like aad try out your growing program. Do it that 
way. It's satisfyingg to watch the display and the operation improve as you 
expand the listing. 


--- AREA OF RT TRIANGLE BY TASK (A task). 

Does CLEAR the page 

and DISPLAY the "CALCULATE THE AREA OF A RIGHT TRIANGLE" 

and CARRIAGE return 

and DISPLAY the "USING A TASK WRITTEN IN SAVVY" 

and CARRIAGE return 

and CARRIAGE return 

and DISPLAY the "ENTER THE LENGTH OF THE BASE OF THE TRIANGLE" 
and INPUT into BASE 

and CARRIAGE return 

10 and DISPLAY the "ENTER THE HEIGHT OF THE TRIANGLE: 

11 and INPUT into HEIGHT 

12 and CARRIAGE return 

13 and CARRIAGE return 

14 and DISPLAY the "I AM NOW MULTIPLYING THE HEIGHT BY THE BASE" 
15 and CARRIAGE return 

16 and MULTIPLY the HEIGHT by the BASE 

17 and DISPLAY the "I AM NOW DIVIDING THE PRODUCT BY 2" 

18 and CARRIAGE return 

19 and DIVIDE the PRODUCT by 2 

20 and COPY from QUOTIENT to ANSWER 

21 and CARRIAGE return 

22 and DISPLAY the "THIS IS THE ANSWER IN SQUARE UNITS:" 

23 and DISPLAY the ANSWER 

24 and CARRIAGE return 

26 and END 


MO 0 -4 U WHY O 


BEGINNERS' MANUAL, SECTION IV (April 1, 1985) Page 4 


NOTE: In line 20 above, the need for the COPY instruction may not be clear. 

In this program, it's not strictly necessary, but in some cases, it is. What 
if your program needed to remember the value in QUOTIENT and yet you needed to 
perform another division operation? The new QUOTIENT value would erase the 
first one. As a matter of insurance, get into the habit of copying QUOTIENTS 
(and SUMS, DIFFERENCES, and PRODUCTS) into other items as soon as they are 
figured. Failure to do this can lead to some incredibly exasperating errors in 
your programs. 


Besides tasks, you'll want to learn to write functions. The details of this 
are covered in Section II. Functions are handy things to have around, since 
they usually require less memory space, are quicker to write and include the 
explanatory prompts in their titles. Functions can be called from within tasks 
just as tasks can be. The listing below is an approach to solving the right 
triangle problem by using a function. Study the listing and compare the 
Operations with the task you wrote up above. 


O --- AREA OF RT TRIANGLE BY FUNCTION With a height of <1> And a base of 
<2> (a Function) 

1 Does CARRIAGE return 

2 and CARRIAGE return 

3 and DISPLAY the "I AM MULTIPLYING THE BASE BY THE HEIGHT" 

4 and MULTIPLY the <1> by <2> 

5 and CARRIAGE return 

6 and DISPLAY the "I AM DIVIDING THE PRODUCT BY 2" 

7 and DIVIDE the PRODUCT by 2 

8 and COPY from QUOTIENT to ANSWER 

9 and CARRIAGE return 

10 and DISPLAY the "THE AREA IS: " 

11 and DISPLAY the ANSWER 

12 and CARRIAGE return 

13 and END 


In this exercise, you have been "learning". If someone else wanted to use this 
program, it would have been "program development". If you had been exploring 
(having fun) on your own initiative, you would have been engaged in the 
infamous practice of "hacking". 


There is no way to learn to program well without a lot of practice. So, pick an 
unfamiliar PRIMARY out of the APPLE SAVVY manual and write a program using it. 
Debug the program, elaborate it, incorporate another unfamiliar command. Try 
Still another primary. Pose yourself problems, develop flowcharts in your head. 
You'll learn and you'll enjoy it. Close the door, take the phone off the hook, 
lay in a supply of frozen pizza, and HACK! Suggestion: try replacing the 
DISPLAY the ANSWER line in your triangle task and function with SHOW... 


SECTION V - HAVING FUN WITH SAVVY 


SAVVY can be used to write some very entertaining programs. This kind of 
programming can be addictive. People who program just because they enjoy 
programming are called "hackers". 


Hacking can be a valuable experience because although you may be writing 
programs that have no real practical value, you are learning about the 
language. When you start developing practical applications, all of the things 
you learned while hacking will be there to help you. 


There are several programs included in this section. Each has a different 


orientation and each can give you other ideas for new things to try - so hack 
to your heart's content. š 


HAVING À CONVERSATION WITH YOUR COMPUTER 

The easiest kind of SAVVY program to write is a dialog program, You can 
tell or ask your computer things about what it knows and it will give you 
logical answers. Of course, you must teach it in advance what you want it to 


know. A dialog program uses very simple commands but the effect can be 
spectacular. 


First, think of several questions you would like to be able to have the 
computer answer. Write these down on a sheet of paper. Next, write down the 
answers you want the computer to give. 


Now you are ready to start your program. 
Here is a sample program: 
Question One is: How are you feeling today? 
Start by typing in: 
DEFINE a task called FEELING TODAY 
You see: 0 ---FEELING TODAY 
Now we enter: 


1 Does CLEAR the page 
2 and CARRIAGE return 
3 and CARRIAGE return 
4 and DISPLAY the "I WAS FEELING JUST FINE UNTIL SOMEONE TURNED ON MY 
POWER. 
and CARRIAGE return 
and DISPLAY the "NOW I HAVE A STRANGE RINGING IN MY 
EARS. 
and RING bell 
and RING bell 
and RING bell 
O and DELAY 


nu 


Oo +‏ © سر 


When you type in DELAY, the menu at the top of the screen will say: 


I have never seen DELAY before. 
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Should I make it a task? (Y/N) 


Type in Y. This is a task you will write in a while, but SAVVY will make 
space for it now. 

Now type in Q. 

Try out the task. Type in FEELING TODAY. 

The task runs, but you need to do something with DELAY. 

So type in: 


EDIT the DELAY 
You see: 0 ---DELAY 
Now enter the following commands: 


] Does COPY from O to SUM 

2 and START a loop 

3 and ADD the SUM and 1 

4 and IF the SUM .. IS EQUAL TO .. 75 then 
5 and RETURN to the previous task 

6 and END of test 

7 and REPEAT this loop 

8 and Q 


When you have entered DELAY, type in FEELING TODAY to see how the task 


runs. It should be fine. Now try asking the comlete question. The task 
should respond the same. Try wording the questions differently: 


HOW ARE YOU TODAY? 
You should get the same answer again. Try asking: 


HOW ARE YOU? 


You will notice that SAVVY recognizes this pattern as belonging to 
something else. You can teach SAVVY to accept this wording for FEELING TODAY, 
too. Type in: 

ASSOCIATE 

You will see: ASSOCIATE new phrase 

Type in: HOW ARE YOU 

You will see: ASSOCIATE new phrase HOW ARE YOU with old 

Type in: FEELING TODAY 

Now type in the new wording, HOW ARE YOU, and see if SAVVY understands. 


You can use ASSOCIATE to teach SAVVY how to respond to many different 
wordings and still give the logical response. 


Time for a new question. 
Question Two: 


Who was the President of the U.S. in 1979 
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DEFINE a task called PRESIDENT IN 1979 
You see: 0 --- PRESIDENT IN 1979 (A task) 
Now type in the following: 


1 Does CLEAR the page 
2 and CARRIAGE return 
3 and CARRIAGE return 
4 and DISPLAY the "LET ME THINK... 
5 and CARRIAGE return 
6 and DELAY 
7 and DISPLAY the "IT WAS JIMMY... 
8 and DELAY 
9 and CARRIAGE return 
10 and DISPLAY the "JIMMY CARTER, BUT HE ONLY SERVED ONE TERM 
11 and Q 
Type in PRESIDENT IN 1979. The task runs just fine. Now try asking the 
question in as many ways as you can think of. Each time you find a question 
wording that SAVVY doesn'e understand, press the ESC key and Q, the ASSOCIATE 
key words out of the new question to the old name. Try out each question. 
If you make an association you don't want to keep, just type in FORGET and 
then the (association to be forgotten). 


Here is the last sample question and answer: 

Question Three: How many keys are on a computer keyboard? 
DEFINE a task called KEYS ON A COMPUTER KEYBOARD 

You see: 0 ---KEYS ON A COMPUTER KEYBOARD (A task) 


Enter the following commands: 


1 Does CLEAR the page 

2 and CURSOR to line 12 character 1 

3 and DISPLAY the "NOW THAT'S A TOUGH QUESTION... 
4 and CARRIAGE return 

5 and .DELAY 

6 and DISPLAY the "IT ALL DEPENDS ON THE COMPUTER 
7 and CARRIAGE return 

8 and DELAY 

9 and DISPLAY the "ME??? 

10 and DELAY 

11 and DISPLAY the "I HAVE ENOUCH. 

12 and Q 


Now try asking the Computer questions about the keyboard and make any 
associations you like. 


Write as many questions and answer routines as you want, to get the feel 
of SAVVY. Remember if you enter something you don't like or want to add other 
information you can EDIT any task and change anything that needs changing. 


SIMPLE GRAPHICS AND ANIMATION 
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Here is a change of pace. How about having the computer put pictures (of 
a sort) on the screen? With pauses from time to time, so you can watch things 
develop? Before you write the actual tasks, you need to write a function that 
will put those pauses in your screen display. To do this, type in: 
FUNCTION 


Now type in: PAUSE 

The screen will display: Number of arguements (1-9) 
Type in: 1 

The screen will display: Prompt for <1> is 

Type in: FOR THIS MANY SECONDS 

Press RETURN 


You see: 0 --- PAUSE for this many seconds: <1> (A Function) 
Now fill in the following commands: 


1 Does COPY the O to LENGTH 

2 and MULTIPLY the «1» by 15 

3 and SPLIT the number PRODUCT 

4 and COPY from INTEGER to PRODUCT 
5 and START a loop 

6 and ADD the 1 and LENGTH 

7 and COPY from SUM to LENGTH 

8 and IF the LENGTH IS EQUAL TO PRODUCT then 
9 and LEAVE this loop 
10 and END of test 
ll and REPEAT this loop 
12 and RETURN to the previous task 
13 and Q 


You are now ready to write in the final task commands. 
DEFINE a task called MIDNIGHT 

You see: 0 --- MIDNIGHT (A task) 

Now fill in the following commands: 


l Does CLEAR the page 
2 and CURSOR to line 22 and character 25 
3 and DISPLAY the "THINK OF A MIDNIGHT SKY 
4 and PAUSE for this many seconds: 2 
5 and CLEAR the page 
6 and STARS 

(When SAVVY asks if this should be a task, answer Y) 
7 and PLANETS 

(When SAVVY asks if this should be a task, answer Y) 
8 and COMET 

(When SAVVY asks if this should be a task, answer Y) 
9 and FLYING SAUCERS 

(When SAVVY asks if this should be a task, answer y) 
10 and PAUSE for this many seconds: 1 
11 and CURSOR to line 22 and character 25 
12 and DISPLAY the "THINK OF A MIDNIGHT SKY 
13 and PAUSE for this many seconds: 4 


(— 
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14 and CLEAR the page 
15 and 0 


This is the final program, but there are several tasks that are undefined 
or contain no commands as yet. Type in MIDNIGHT to see how your task runs. It 
doesn't look too good, does it? You need to add the commands to the other 
tasks you told SAVVY you wanted. If you don't remember what they were called, 
type in: 


LIST the TASKS 


You will see several task names you didn't know were there. These come 
with SAVVY from the factory and you will learn what to do with these iater. 
For now, you just want the names of the ündefined tasks that belong with 
MIDNIGHT. 

You need to EDIT each of these tasks and fill in the program commands. 
Type in: 


EDIT the STARS 


Now fill in the following commands: 

O --- STARS (A task) 

1 Does CLEAR the page 

2 and AT line 22 character l display: "LET'S HAVE SOME STARS" 
3 and AT line 6 character 12 display: "*" 
4 and AT line 8 character 70 display: "*" 
5 and AT line 12 character 30 Display: "*" 
6 and DELAY 

7 and AT line 15 character 55 display: "x" 
8 and AT line 19 character 42 display: "*" 
9 and DELAY 

10 and AT line 2 character 17 display: "*" 
11 and AT line 22 character 1 display: "*" 
12 and Q 


First type in STARS to see how it looks. Then type in MIDNIGHT to see how 
it has changed. It looks better, but it is definitely not finished. The next 
task to EDIT is PLANETS. Type in EDIT the PLANETS and add the following 
commands: 


O --- PLANETS (A task) 


1 Does AT line 22 character 1 display "ADD A FEW PLANETS" 

2 and AT line 18 character 14 display "0" 

3 and AT line 7 character 71 display "0" 

4 and DELAY 

5 and AT line 22 character 70 display "0" 

6 and DELAY 

7 and AT line 22 character 1 display " (at least 17 blank spaces) " 
8 and Q 


Now see what PLANETS does, then see how MIDNIGHT is coming along. Better, 
but still not right. 


EDIT the COMET 


0 --- COMET (A task) 
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Does 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 


Try out 


AT 
AT 
AT 
AT 
AT 
AT 
AT 
AT 
AT 


line 
line 
line 
line 
line 
line 
line 
line 
line 


DELAY 


AT 
Q 


COMET, then MIDNIGHT. 


line 


22 


character 
character 
character 
character 
character 
character 
character 
character 
character 


character 


Now, EDIT the FLYING SAUCER. 


Does 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 


AT 


AT 


line 
line 
line 
line 
line 
line 
line 
line 
line 
line 
line 
line 
line 
line 
line 
line 
line 
line 
line 
line 
line 
line 
line 
line 
line 


FLYING SAUCER (A task)‏ سس 


character 
character 
character 
character 
character 
character 
character 
character 
character 
character 
character 
character 
character 
character 
character 
character 
character 
character 
character 
character 
character 
character 
character 
character 
character 


FLYING SAUCER 1 


and Q 


1 display 
5 display 
6 display 
7 display 
8 display 
9 display 


Page 6 


"HERE COMES A COMET" 
"nU 
nn 
nyn 
"neut 
"e 


10 display "*" 


8 display 
9 display 


l display 


You are 


nyit 
ngn 


" (at least 18 blank spaces) " 


almost there. 


Fill in the following commands: 


display 
display 
display 
display 
display 
display 
display 
display 
display 
display 
display 
display 
display 
display 
display 
display 
display 
display 
display 
display 
display 
display 
display 
display 
display 


— — — — — —— مم — r>‏ — — مم — مر — سم مم م سوم سر سما سم مم سم 


"<<< 

"G- >>> 

GE 

"GET=>>>" 

"GET ->>>" 

"GET Y->>>" 

"GET YO->>>" 

"GET YOU->>>" 

"GET YOUR->>>" 

"GET YOUR ->>>" 

"GET YOUR S->>>" 

"GET YOUR SH->>>" 

"GET YOUR SHU->>>" 

"GET YOUR SHUT->>>" 

"GET YOUR SHUTT->>>" 

"GET YOUR SHUTTL->>>" 

"GET YOUR SHUTTLE->>>" 

"GET YOUR SHUTTLE ->>>" 

"GET YOUR SHUTTLE T->>>" 
"GET YOUR SHUTTLE TI->>>" 
"GET YOUR SHUTTLE TIC->>>" 
"GET YOUR SHUTTLE TICK->>>" | 
"GET YOUR SHUTTLE TICKE->>>" 
"GET YOUR SHUTTLE TICKET->>>" 
"GET YOUR SHUTTLE TICKET ->>>" 


Note that FLYING SAUCER | is used as a continuation of FLYING SAUCER. 
Although it is a separate task, your program will run as if they were one task. 
The task is divided into two parts to prevent it from getting too large for 
your Apple computer to handle. You can should use this technique any time you 
are developing a long single application. 


Now EDIT the FLYING SAUCER 1 and fill in the commands: 


0 --- FLYING SAUCER 1 (A task) 
1 Does AT line 13 character 


1 


1 display 


"GET YOUR SHUTTLE TICKET N->>>" 
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2 and AT line 13 character 1 display "GET YOUR SHUTTLE TICKET NO->>>" 
3 and AT line 13 character 1 display "GET YOUR SHUTTLE TICKET NOW->>>" 
4 and AT line 13 character 1 display "GET YOUR SHUTTLE TICKET NOW!->>>" 
5 and RING hell 

6 and RING bell 

7 and RING bell 

8 and COPY from 29 to COLUMN (Tell SAVVY Y to make COLUMN an item) 

9 and START a loop 

10 and IF the COLUMN IS EQUAL TO 76 then 

ll and LEAVE this loop 

12 and END of test 

13 and AT line 13 character COLUMN display " ->>>" 

14 and ADD the 1 and COLUMN 

15. and COPY from SUM to COLUMN 

16 and REPEAT this loop 

17 and AT line 13 character 76 display " " 


First try out FLYING SAUCER (it will go to FLYING SAUCER 1 by itself), 
then your MIDNIGHT program. Remember to CLEAR the page first. 


Notice how the loop you put in FLYING SAUCER 1 takes the "space ship" 
across the screen with very little programming. Loops are very valuable; they 
save programming time and memory space. You will get more practice later. 


If the task MIDNIGHT reminds you of other words, you might want to 
associate those other words or phrases to the task name MIDNIGHT, such as 
PLANETARY DISPLAY, A LOOK AT THE HEAVENS, or UNIVERSAL SHOW. 


You can enhance this group of tasks by adding more stars, planets, or what 
have you. You might want to make a falliag star or two. You could use the 
technique that produced the comet, or to be more elegant, you could use the 
looping technique that moved the flying saucer across the screen. Also, after 
you have more experience, experiment with using the CUT and PASTE and the FRONT 
and BACK commands (see the Reference Guide) to write a more efficient way of 
presenting the "BUY YOUR SHUTTLE..." message. The MIDNIGHT group of tasks is 
not intended to be efficient; it can be improved in many ways, which is left to 
your ingenuity. Hack with it until you are satisfied with the effects. 


QUESTIONS AND ANSWERS 


It is time to explore some more of SAVVY's unique features. In the next 
example you will write a task that will have the computer give information, ask 
for answers, evaluate them and let you know if your answers are right or wrong. 
If an answer is wrong, the task may take you to another task that helps you 
figure out what you need to know before trying to answer the question again. 
This is called branching and can be very useful in many kinds of programs. 


The example below contains nonsense information but you could substitute 
real information just as well. Notice that the answers are handled differently 
for each question. If the first question, only one answer is considered 
correct, in the second question, two different answers can be correct. In the 
third question, the computer branches to a new task to give you the information 
that correctly answers the question. 


You can expand on these ideas to make more elaborate and more responsive 
programs. Study the conditional statements in the reference guide for more 
ideas. Experiment to see what happens. 
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DEFINE a task called WILD BILL 


Enter the commands below: 


0 
1 
2 
3 
4 


un 


== WIEBE (A task) 


Does 
and 
and 
and 


and 


and 
and 
and 
and 
and 
and 
and 
and 
and 
and 

do 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 


CLEAR the page 

FREE...I'll use my best judgement 
CARRIAGE return 

CARRIAGE return 


DISPLAY the "WILD BILL WAS BORN IN A TOWN IN ILLINOIS IN THE 
SUMMER OF 1932. 
CARRIAGE return 
DISPLAY the "HE WAS MARRIED TO CRAZY JAYNE. 
CARRIAGE return 
CARRIAGE return 
CARRIAGE return 
DISPLAY the "WHEN WAS BILL BORN? 
CARRIAGE return 
LABEL this line "ASK AGAIN 
INPUT the ANSWER 
IF the ANSWER IS "IN THE SUMMER OF 1932" then 
CARRIAGE return 
DISPLAY the "YOU GOT IT!" 
OTHERWISE 
CARRIAGE return 
DISPLAY the "TRY AGAIN" 
CARRIAGE return 
GO to the line called "ASK AGAIN" 
END of test 
CARRIAGE return 
DISPLAY the "WHO WAS HIS WIFE?" 
CARRIAGE return 
LABEL this line "ASK 2" 
INPUT into ANSWER 
IF the ANSWER IS "JAYNE" then 
CARRIAGE return 
DISPLAY the "YOU GOT IT!" 
OTHERWISE ; 
IF the ANSWER IS "CRAZY JANE" then 
CARRIAGE return 
DISPLAY the "YOU GOT IT!" 
CARRIAGE return 
OTHERWISE 
CARRIAGE return 
DISPLAY the "TRY AGAIN" 
CARRIAGE return 
GO to the line called "ASK 2" 
END of test 
END of test ç 
LABEL this line "ASK 3" : 
DISPLAY the "WHAT WAS THE NAME OF THE TOWN WHERE HE WAS BORN?" 
CARRIAGE return 
INPUT into ANSWER 
IF the ANSWER IS NOT "CORN FIELD" then 
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49 and 
50 and 
51 + and 
52 and 
53: and 
54 and 
55 and 
56 and 
57 and 
58 and 
59 and 


CARRIAGE return 

CARRIAGE return 

CORN FIELD 

CARRIAGE return 

GO to the line called "ASK 3" 
OTHERWISE 

CARRIAGE return 

DISPLAY the "YOU GOT IT!" 

DELAY 

END of test 
Q 


Now EDIT the CORN FIELD and fill in the following commands: 


0 --- CORN FIELD (A task) 

1] Does CARRIAGE return 

2 and DISPLAY the "CORN FIELD IS LOCATED IN ILLINOIS, EXACTLY WHERE IS 
HARD TO SAY" š 

3 and CARRIAGE return 

& and DISPLAY the "IT IS MADE UP OF 2 SHACKS AND A TENT, SOMETIMES." 

5 and CARRIAGE return 

6 and DISPLAY the "WILD BILL CALLS IT HOME BECAUSE THAT IS WHERE HE 
WAS BORN.": 

7 and PAUSE for this many seconds: 15 

8 and RTURN to the previous task. 

9 and Q 
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VI. WRITING YOUR FIRST APPLICATION 


You are ready to write your own complete application. The examples used 
may not be what you eventually plan to do with SAVVY but they will give you a 
good idea of how to write numerous tasks and integrate them into a whole. 


The first example is how to get the computer to keep track of loans. 
Before you can decide what tasks need to be written you need to decide what has 
to be done to keep track of a loan. For all of you who are not financial types 
there are five things that are commonly done on a daily basis. These are: 


1. Add new loans to the loan file. 

2. Change the information on existing loans. 

3. Delete (or remove) a loan from the file when it is paid. 

4. Find specific loans so you can answer any questions about them. 
5. List all of the loans and the total amount of money loaned out. 


Now, what does the computer need to keep track of to be able to do these 
five things? For each loan you need: 


LOAN NUMBER DUE DATE PRINCIPAL 
NAME ADDRESS INTEREST RATE 
INTEREST DUE AMOUNT DUE 

PHONE 


We also want to know: 
TOTAL LOAN AMOUNT 


What information will you need to put into the computer so it can give you 
the information you want? You will need to put in: 


LOAN NUMBER DUE DATE 


NAME PRINCIPAL 
ADDRESS INTEREST RATE 
PHONE 


Next, how do you want the computer to process the information so it can 
figure the: INTEREST DUE, AMOUNT DUE and TOTAL LOAN AMOUNT? 


The formulas are: 


INTEREST DUE = PRINCIPAL times INTEREST RATE 
AMOUNT DUE = PRINCIPAL + INTEREST DUE 
TOTAL DUE = the sum of all the loan PRINCIPALS in the file. 
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Now that you know what information the computer needs to recognize; what 
information you need to enter and what formulas need to be used to give you 
back the results you want, you need to decide what files, items and tasks you 
need to write to keep track of the loans. Refer back to Section 11 for 
definitions of files and items if you want to. 


Before you start actually writing tasks and developing programs, it is a 
good idea to decide what should be done first, second, third, etc. This will 
speed up the job. Remember, you will need to test each task you write to be 
sure it performs its job correctly. 


Below is a step by step guide to writing the program: 


Create 
Define 
Define 
Define 
Define 
Define 
Define 
Define 
Define 
Define 
Define 


سر O xO Qo + Qv Qn un‏ سر 


mM سم‎ 


b b b bp b b دم‎ MD ده‎ og 


a 


file 
task 
task 
task 
task 
task 
task 
task 
task 
task 
task 


above tasks. 


to 
to 
to 
to 
to 
to 
to 
to 
to 
to 


save the records (l record for each loan.) 
ask for one loan record. 

show one loan record. 

compute the amount due. 

add records to the loan file. 

list all records in the loan file. 

change a record in the loan file. 

delete a record in the loan file. 

find a record in the loan file. 

display the loan menu. 


that processes loans by combining all of the 


sr 


All of the tasks you need are given below with an explanation of what each- 
does and how to test it. For this first example it is a good idea to follow the 
instructions exactly. 


Remember the SAVVY conventions: 


- Press RETURN after each entry. 
- Answer the questions SAVVY asks about tasks 


and items. 


- Once you have entered the commands for each 
task press Q and return. 

- If you make mistakes, use the editor. 

- If you feel you are stuck use ESC-F and start 
over from where you had a problem. 


First, you must create a new file and tell the computer what information 
is to be kept in that file. To do this type in: 


CREATE 


The screen will display: CREATE a folder called 


Now type in the file name, which in this case is: LOANS 


The screen will display: 


File LOANS 


1 ID 
2 Item 
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As you will remember, SAVVY needs a key word to use to index information. 
The screen displays ID as the key. The ID stands for identification. This needs 
to be changed to reflect your situation. Type in D and press return to delete 
the ID. Now replace it with LOAN NUMBER and press return. Next SAVVY asks for 
an ITEM. 


The next ITEM you have is NAME, so type it in and press return. If you are 
the FREE mode, SAVVY will think you want LAST NAME and substitute it for NAME. 
Since in this case that is not what you want, type Q to quit. At the ready 
message type in LITERAL. Once you have done that, EDIT the LOANS. Now delete 


the LAST NAME and type in NAME. SAVVY will ask if that should be an item. 
Answer Y. 


Continue adding all of the items listed below and telling SAVVY that each 
should be an item. When you have finished, type Q to quit. Your blank form is 


ready to store data, but you have no way to use it yet. Your screen will look 
like this: 


LOANS (a File) 

Key LOAN NUMBER 
Item NAME 

Item ADDRESS 

Item PHONE 

Item DATE DUE 

Item AMOUNT DUE 
Item PRINCIPAL 
Item INTEREST RATE 
Item INTEREST DUE 
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You are ready to DEFINE a task to ASK FOR LOAN RECORD. Before you start, 
read the task over. It is listed below: 


ASK FOR LOAN RECORD (a Task) 
1 Does LIMIT the input for LENGTH OF PROMPT to a maximum of 15 
2 and START a loop 
3 and ASK FOR the LOAN NUMBER 
4 and ASK FOR the NAME 
5 and ASK FOR the ADDRESS 
6 and ASK FOR the PHONE 
7 and ASK FOR the PRINCIPAL 
8 and ASK FOR the INTEREST RATE 
9 and ASK FOR the DATE DUE 

10 and ASK this: "IS THE ABOVE CORRECT?" 

11 and IF the ANSWER .. IS .. YES then 

12 and LEAVE this loop 

13 and END of test 

14 and REPEAT this loop 


Q 


Notice the command ASK FOR. This is not a command that comes with SAVVY 
but a function that you must write yourself. The listing for this function is 
in Appendix B, page 1. Turn to that page now and type in the FUNCTION. 


Now return to the job at hand. Enter the task as listed above until you 


come to the command that reads ASK this:. This is another useful function that 
is listed in Appendix B. Type in REPEAT then Q to exit the editor. 
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Go to Appendix B, page l and type in the ASK function. Try it out to be 
sure it works. Now go back and EDIT the ASK FOR LOAN RECORD and finish adding 
the programming commands. When you have all of the commands entered leave the 
editing mode and try out the task by typing in the task name and entering test 
information at the right spots. You are ready to DEFINE the next 
task which is SHOW THE LOAN RECORD. Go ahead and do this now. This task does 
not require that you write any new functions. 


SHOW THE LOAN RECORD (a Task) 


Does LIMIT the input for LENGTH OF SHOW to a maximum of 15 
and SHOW the LOAN NUMBER 
and SHOW the NAME 
and SHOW the ADDRESS 


1 
2 
3 
4 
5 and SHOW the PHONE 
6 and SHOW the PRINCIPAL 
7 and SHOW the INTEREST RATE 
8 and SHOW the INTEREST DUE 
9 and SHOW the AMOUNT DUE 
10 and SHOW the DATE DUE 
LT ۵ -Q 

Try out the task. Notice that some of the test information you entered in 
ASK FOR LOAN RECORD has been saved, but that two items have no information in 
them. These are INTEREST DUE and AMOUNT DUE. This is because you have not told 
SAVVY how to calculate these figures yet. You will do this next. 


Now you are ready to DEFINE the task that will COMPUTE AMOUNT DUE. Read 
through the task listing below: 


COMPUTE AMOUNT DUE (a Task) 


1 Does DIVIDE the INTEREST RATE by 100 
2 and MULTIPLY the PRINCIPAL by QUOTIENT 
3 and COPY from PRODUCT to INTEREST DUE 
4 and ROUND the INTEREST DUE to ۰01 -ths. 
5 and ADD the PRINCIPAL and INTEREST DUE 
6 and COPY from SUM to AMOUNT DUE 

Q 


All of the commands look familiar but one. ROUND is not an original SAVVY 
command. You guessed it, it is another function. The listing for this function 


is given in Appendix B, page 3. Type in the function before you DEFINE the new 
task. 


You are ready to DEFINE the COMPUTE AMOUNT DUE. After you have entered 
this task, test it by first typing in ASK FOR LOAN RECORD. After you have 
filled in some sample information, COMPUTE AMOUNT DUE and ask the computer to 
SHOW THE LOAN RECORD. If you have entered all of the commands correctly, you 


should see the information you filled in plus the INTEREST DUE and the AMOUNT 
DUE. 


Now you need to write tasks that will manage the loan information and let 
you manipulate this information in meaningful ways. 


BEGINNERS' MANUAL, SECTION VI (April 1, 1985) Page 5 


The first management task is to add new records to the loan file and save 
these records for future reference. To do this you will DEFINE the task ADD 
RECORDS TO LOANS. Read through the task to see if you need to write any new 
functions before you actually begin with the task. 


ADD RECORD TO LOANS (a Task) 

1 Does START a loop 

2 and CLEAR the page 

3 and ASK FOR LOAN RECORD 

4 and COMPUTE AMOUNT DUE 

5 and SHOW the AMOUNT DUE 

6 and WHEN folder LOANS .. DOES NOT CONTAIN .. LOAN NUMBER then 
7 

8 

9 


and SAVE new page in LOANS 
and OTHERWISE y 
and SAY this: "LOAN NOT SAVED, BECAUSE LOAN NUMBER ALREADY 
ASSIGNED." 
10 and END of test 


11 and ASK this: "DO YOU WANT TO ADD ANOTHER LOAN? 
12 and IF the ANSWER .. IS .. NO then 


13 and , LEAVE this loop 
14 and END of test, 

15 and REPEAT this loop 
16 and Q 


Here, there is another function to write, SAY. Turn to Appendix B, page 3 
to find the listing for the function. 


When you have entered the function, you are ready to DEFINE the ADD 
RECORDS TO LOANS. Type in the commands. Notice that you are telling SAVVY to 
automatically do the tasks you entered manually to test the COMPUTE AMOUNT DUE. 


You are also telling it to only save new loan numbers, so there will be no 
duplication of information. 


Now test the task by adding two or three sample loans along with all other 
information requested for each record. 


You need a way to see all of the information that is stored in the LOANS 
file. You can do this by defining a task called LIST ALL RECORDS IN LOANS. 
Again, before actually defining the task, read it over to see if any other 
functions or tasks need to be written first. 


LIST ALL RECORDS IN LOANS (a Task) 

1 Does CLEAR the page 

2 and OUTPUT COLUMN called "LOAN" using format 5 

3 and OUTPUT COLUMN called "NAME" using format 20 

4 and OUTPUT COLUMN called "AMOUNT DUE" using format 12 
5 and OUTPUT COLUMN called "DATE DUE" using format 16 
6 and OUTPUT COLUMN called "PHONE" using format 16 

7 and SET the TOTAL DUE to 0 

8 and BEGIN at page indexed by FIRST in folder LOANS 
9 and START a loop 
10 and GET the page indexed by NEXT in folder LOANS 
11 and IF the PAGE IS EMPTY then 
12 and LEAVE this loop 
13 and OTHERWISE 
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14 and CARRIAGE return 

15 and OUTPUT COLUMN called LOAN NUMBER using format 5 
16 and OUTPUT COLUMN called NAME using format 18 

17 and OUTPUT COLUMN called AMOUNT DUE using format 12.2 
18 and OUTPUT COLUMN called DATE DUE using format 16 

19 and OUTPUT COLUMN called PHONE using format 16 

20 and INCREASE the TOTAL DUE by AMOUNT DUE 

21 and END of test 


22 and REPEAT this loop 

23 and SHOW the TOTAL DUE 

24 and ASK this: "IS THIS LIST CORRECT?" 
25 and IF the ANSWER IS YES then 

26 and RETURN to previous task 

27 and OTHERWISE 

28 and CHANGE RECORDS IN LOAN 

29 and END of test 

30 andQ 


There are three new functions in this task: OUTPUT COLUMN, SET, and 
INCREASE. Write the three functions now (Appendix B, pages 3, 3, and 2, 
respectively). 


Now DEFINE the LIST ALL RECORDS IN LOANS and enter the commands. 

You are ready to try out the task. Type in LIST ALL RECORDS IN LOANS and 
see what happens. You should get the information for each loan in numeric order 
by loan number. At the end you should get the total amount due which includes 
principal and interest. 


You need a way to change the information in each loan record if someone 
moves, borrows more money, makes a payment, etc. The next task will let you do 
this. DEFINE a task called CHANGE RECORD IN LOANS. Type in all of the commands 
below: 


CHANGE RECORD IN LOANS (a Task) 

1 Does CLEAR the page 

2 and ASK FOR the LOAN NUMBER 

3 and WHEN folder LOANS .. CONTAINS .. LOAN NUMBER then 
4 and GET the page indexed by LOAN NUMBER in folder LOANS 
5 and SHOW THE LOAN RECORD 

6 and ASK FOR LOAN RECORD 

7 and COMPUTE THE AMOUNT DUE 

8 and SHOW the AMOUNT DUE 

9 and REPLACE this page in folder LOANS 

10 and OTHERWISE 

11 and SAY this: "I CAN'T FIND THAT RECORD." 

12 and END of test 

14 and Q 


Now try out the task and change some of your sample information. After you 
have done this try typing LIST ALL RECORDS IN LOANS and see if the information 
has been changed. 


You can now change information in your files, but you need a way to delete 
information if someone pays off their loan. You don't need to clutter up the 
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computer's memory with information you aren't using so DEFINE a task called 
DELETE RECORD FROM LOANS. Enter the commands below: 


DELETE RECORD FROM LOANS (a Task) 


1 Does CLEAR the page 

2 and ASK FOR the LOAN NUMBER 

3 and WHEN file LOANS .. CONTAINS .. LOAN NUMBER then 

4 and GET the page indexed by LOAN NUMBER in folder LOANS 
5 and SHOW THE LOAN RECORD 

6 and ASK this: "DO YOU WANT TO DELETE THIS RECORD?" 

7 and IF the ANSWER ...IS .. YES then 

8 


and DELETE the page indexed by LOAN NUMBER from folder LOANS 
9 and SAY this: "RECORD DELETED" 
10 and END of test 
11 and OTHERWISE 
12 and SAY this: "I CAN'T FIND THAT LOAN." 
13 and END of test 
14 and Q 


When the ‘commands are all entered, try the task. Delete one of you sample 
records. To be sure it has been deleted, type in LIST ALL RECORDS IN LOANS and 
see if it is still there. You will find it gone. 


Before you go on to the next task, add another loan to the file so you 
will have enough information to work with. 


You can list, show, add, change or delete records but it would be nice to 
be able to find a specific record or move around within the file. Here is a 
task that will let you do just that. Enter it into the computer. 


FIND RECORD IN LOANS (A Task) 

1 Does CLEAR the page 

2 and ASK FOR the LOAN NUMBER 

3 and BEGIN at page indexed by LOAN NUMBER in folder LOANS 

4 and GET the page indexed by THIS in folder LOANS 

5 and START a loop 

6 and SHOW the LOAN RECORD 

7 and SAY this: "ENTER N FOR NEXT RECORD, P FOR PREVIOUS, OR Q 
TO QUIT ec! 

8 and LIMIT the input for ANSWER to a maximum of 1 

9 and IF the ANSWER .. IS .. "Q" then 


10 and LEAVE this loop 

11 and OTHERWISE 

12 and IF the ANSWER .. IS .. "N" then 

13 and GET the page indexed by NEXT in folder LOANS 
14 and END of test 

15 and IF the ANSWER .. IS .. "P" then 

16 and GET the page indexed by PREVIOUS in folder LOANS 
17 and END of test 

18 and END of test 

19 and REPEAT this loop 

20 and Q 


Check your task by typing in the task name and using each of the options 
to move around in the LOANS file. 
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You can manipulate all of the information in the LOANS file by typing in 
the name of each task you want the computer to execute. A much more elegant 
solution would be to have a "MENU" display all of the things you can do, and 
then make only a single keystroke selection. The next three tasks will create 
that sort of a menu for you. 


Start by entering the following task: 


DISPLAY 


1 
2 
3 
4 


5 


8 
9 


Does 
and 
and 
and 
and 
and 
and 


and 


and 


LOAN MENU (a Task) 

CURSOR to line 1 and character 33 

DISPLAY TITLE of "PROCESS LOANS" 

SET the LEFT MARGIN to 20 . 

AT line 4 and column LEFT MARGIN display "1. ADD A RECORD TO 
LOANS." 

AT line 6 and column LEFT MARGIN display "2. CHANGE A RECORD IN 
LOANS." 

AT line 8 and column LEFT MARGIN display "3. DELETE A RECORD 
FROM LOANS." 

AT line 10 and column LEFT MARGIN display "4. FIND A RECORD IN 
LOANS. 

AT line 12 and column LEFT MARGIN display "5. LIST ALL THE 
RECORDS IN LOANS. 

Q 


When you test this task, all you will see is the menu printed over the 
exisitng task, unless you CLEAR the screen first. 


Now we need to write a task that will let you make a selection from the 
PROCESS LOANS menu and then will dowhat you specify. To do this, enter the task 


below: 


PROCESS LOANS (A task) 


Does 
and 
and 
and 
and 
and 
and 


and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 


CLEAR the page 
START a loop 
DISPLAY LOAN MENU 
COPY from O to CHOICE 
CARRIAGE return 
CARRIAGE return 
OUTPUT from "PLEASE ENTER THE NUMBER OF YOUR CHOICE" using 
format 600 
CARRIAGE return 
OUTPUT from "OR PLEASE ENTER Q TO QUIT" using format 600 
LIMIT the input for CHOICE to a maximum of 2 
IF the CHOICE is "Q" then 
LEAVE this loop 
END 
IF the CHOICE is "I" then 
ADD RECORDS TO LOANS 
END of test 
IF the CHOICE is "2" then 
CHANGE RECORDS IN LOANS 
END of test 
IF the CHOICE is "3" then 
DELETE RECORDS FROM LOANS 
END of test 
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23 and IF the CHOICE is "4" then 


24 and FIND RECORD IN LOANS 

25 and END of test 

26 and IF the CHOICE is "5" then 

27 and LIST ALL RECORDS IN LOANS 
28 and END of test 


29 and REPEAT this loop 
30 and CLEAR the page 
31 and Q 


Now try PROCESS LOANS to be sure everything works right. Be sure to test 
each menu selection. When you are sure all is correct, you can clean out the 
sample information you used to test your tasks. 


By typing in ERASE, the screen will display: 
ERASE all pages in folder 
You type in LOANS and press return. Your program is ready for serious work. 


You can experiment with enhancing the program by having the bell ring if a 
loan is over a certain amount or if the date shows overdue, You could have the 
computer keep track of how many loans are outstanding or how many loans have 
been made to date, using a function called INCREMENT: 


INCREMENT the <1> (a function) 
1 Does ADD the 1 and <l> 

2 and COPY from SUM to «1» 
END 


You have written a program that manages information and calculates 
numerical values for you. It's time to try a different kind of program. 


Think back to the part of Section II headed Program. The second example 
was a program that would tell you what kids of clothing to wear in different 
parts of the world at different times of the year. Your job now is to figure 
out how to write such a program. You will get a few hints to help you along the 
way, but the thinking and the code are up to you. (If you really get stuck, 
there is a listing of each task in Appendix C). 


Go back and review the preliminary steps for writing a program in part 1 
of this section. Then think about the things your new program will need to do: 


1. Add information about new locations. 
2. Change information about locations. 
3. Find specific locations for specific seasons of the year. 


4. Remove information about a location if you know you will never need it 
again. 


What information does the computer need to provide you with about each 
location? 


LOCATION NAME 
TEMPERATURE RANGE 
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WIND CONDITIONS 
PRECIPITATION 
BASIC CLOTHING 
OVERCOAT 

RAIN GEAR 

MISC. 


In this case, you will need to put all of the information about location 
name, temperature range, precipitation, wind conditions and misc. for each 
location into the computer. The computer is going to decide on the basic 
clothing, overcoat and rain gear, and misc. for you. 


Next, you need to decide how you are going to store the information. Will 
it all go into one file, or will it go into separate files? Do you want a month 
by month system, or will season by season do? 

What steps need to be taken first? Which steps come next, and what are the 
final steps to tie all of the tasks together? Below is one possible approach: 


l. Create a file for the weather. 

2. Define a task to get a blank record from the file. 
3. Define a task to show one record from the file. 

4. Define a task to decide on the basic clothing. 

5. Define a task to decide on rain gear. 

6. Define a task to add a record to the file. 

7. Define a task to change a record in the file. 

8. Define a task to delete a record. 

9. Define a task to find a record. 

10. Define a task to display a menu. 

11. Define a task to give the appropriate information. 


You could decide you wanted a file for every location you might visit and 
have different records for each month or season. This is not a very efficient 


approach because you would end up with a large indeterminate number of files if 
you travel a lot. 


You could decide to have a file for each month, which is a little more 
precise, but still a bit cumbersome unless you need very specific details. 


You could decide to have a file for each season, which is a functional 
solution, or you could decide to have one file and enter the locations and the 
season together in the key item. This is the approach used in Appendix C. 


Once you have decided how you are going to access the information in the 
files to ADD, DELETE, CHANGE, SHOW and FIND data you are all ready to design 
the menu that will allow you to conveniently access the information you want. 


Now plan your steps, design your tasks and your menus, and see what 
happens. Remember, there are examples in Section » page , but use 
them only as a last resort. 
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Once you have this program running successfully, you are ready to start to 
develop your own applications. There are, of course, many SAVVY commands that 
you have not yet used. Read about them in the SAVVY Reference manual and 
experiment with them to learn how they can help you in program development. 
Learning any computer language takes time and practice, but you now have the 
basics to grow into SAVVY. Good luck, and have fun! 
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APPENDIX A 


1. FILES: In SAVVY, files are not "opened" or "closed". Files are always 
open. The record pointer is positioned to the record saved, gotten, replaced, 
or deleted most recently. All files have the logical structure of indexed 
sequential files, with variable length records and fields. 


2. DELETIONS: Items, tasks, functions, and files may not be deleted. All of 
these features are "global", accessible from any task, function, or file. To 
delete one of them from the DICTIONARY would require SAVVY to check all 
tasks, functions, and files, to make sure that the deleted element is not being 
used. This would require an unacceptably long period of time. 

As an alternative, you should delete all the instructions out of a task, 
reducing the disk space requirement to about 10 bytes, and then rename the 
task. This is fast to do. A good name might be Z SPAREn or Z AVAILn. The "Z" 


ensures that the empty task is moved to the end of the (alphabetical) task 
list. 


3. EDITOR: The editor is an interactive compiler. It produces code that is 
selfloading, serially reuseable, and self relocating. At compilation, the code 


is automatically link-edited. 


4. DATA TYPES: The only basic data type is "string" data. A new data type 


may be defined by using a FUNCTION to force the data to meet your 


specifications. 


5. BASIC keywords and SAVVY equivalents: 


ABS No analog 

AND AND 

ASC Not used in SAVVY 
ATN Note 5 

AUTO No analog 

CDBL No analog 

CHRS Not used in SAVVY 
CINT Note 1 

CLEAR Note 1 

CLOSE Note 2 

CLS CLEAR the page. 
CONT No analog 


cos 
CSNG 
CVD 
CVI 
CVS 
DATA 
DATES 
DEFDBL 
DEF FN 
DEFINT 
DEFSNG 
DEFSTR 
DELETE 
DIM 


EDIT 
END 
ERASE 
ERR 
ERROR 


FN 
FOR-NEXT 
GET 
GOSUB 
GOTO 
HEXS 
IF 

IMP 
INKEYS 
INPUT 
INPUT# 
INPUTS 
INSTR 
INT 
KILL 
LEFTS 
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Note 5 

No analog 

Note 1 

Note 1 

Note 1 

No analog 

GET DATE into... 
Note 1 

FUNCTION 

Note 1 

Note 1 

Note 1 

D(elete this line) 
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No analog in SAVVY. Arrays are stored as folder data, in an 


open-ended file. 

EDIT the... 

Inserted automatically, upon Q command. 
FORGET. See your user's manual. 


Various REPORT ... ERROR messages. See your users' manual 
Various REPORT ... ERROR messages. See your users' manual 


No analog 

Note 3. 

FOLDER 

INTEGER 

FUNCTION 

BEGIN A COUNTED LOOP... 
Note 2 

No analog. "Subroutines" are independent tasks. 
JUMP to the line called... 
Not used in SAVVY 

IP the... 

No analog 


No analog 


INPUT the... 
No analog 
No analog 
No analog 
Note 1 

No analog 
Note 4 
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LEN LENGTH (an item). See your user's manual. 
LET No analog 
LINE No analog; see ncte l 
LIST In editing, L 
LLIST Use L, after selecting PAPER 
LOAD No analog 
LOC Note 2 
LOF Note 3 
LOG Note 5 
LPRINT PAPER selected 
LSET Note 2 
MEM No analog 
MERGE No analog 
MIDS Note 4 
MKD$ Note 1 
MKIS Note 1 
MKSS$ Note 1 
MOD No analog 
NEW No analog 
NEXT No analog 
NOT IS NOT 
OCTS Not used in SAVVY 
ON No analog 
OPEN Note 2 
OR OR 
PEEK Not used in SAVVY 
POKE Not used in SAVVY 
POS READ. See your users' manual 
PRINT SHOW the, DISPLAY the 
PRINT# No analog 
PUT Note 2 
RANDOM Random numbers are generated from a user-written function 
READ No analog 
REM Not used in SAVVY 
RENUM No analog. Renumbering is automatic in the SAVVY editor 
RESTORE No analog. 
RESUME RESUME (not the same as BASIC. See your user's manual 
RETURN RETURN to the previous task. 
RIGHTS Note 4 
RND See RANDOM above 
ROW READ. See your users' manual 
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RSET Note 2 
RUN No analog 
SAVE Note 2 
SGN . No analog 
SIN Note 5 
SPACES No analog. Use a user-defined FUNCTION 
SPC No analog. Use a user-defined FUNCTION 
SQR Use MULTIPLY primary to calculate Squares. 
STEP No analog 
STOP No analog 
STRS Note 1 
STRINGS Note 1 
SWAP No analog 
SYSTEM SYSTEM 
TAB OUTPUT. See user's manual. 
TAN Note 5 
THEN "then" is automatic after the IF instruction 
TIMES No analog 
TO "to" is automatic in the COUNTED LOOP 
TROFF No analog 
TRON No analog 
USING See your user's manual for formatting techniques. 
USR No analog. All tasks in SAVVY are stored in compiled form. 
VAL No analog š 
VARPTR No analog 
VERIFY No analog 
XOR No analog 
NOTES: 


1. In SAVVY, all variables are stored in RAM and on disk as strings. Reserving 
Space for strings or arrays, defining variables as integer, single, or double 
precision, or converting variables to a different format for disk storage 
purposes are unnecessary operations. 


2. SAVVY does not use disk file buffering statements. Storing programs or data 
to disk is automatic from any location in RAM. 


3. Disk file management and i/o is automatic in SAVVY. Specification of field 
lengths or record length are unnecessary operations 


4. See the "character manipulation" section in the SAVVY user's manual. 


5. Trig functions and logs are not part of SAVVY, initially. They can be 
calculated during program execution via user-prepared functions. 


APPENDIX B 


ASK this: <I). (a Function) 


1 START a loop 

2 CARRIAGE return 

3 DISPLAY the <1> 

4 DISPLAY the " (Y or N) " 

5 LIMIT the input for ANSWER to a maximum of 1 
6 IF the LENGTH .. IS .. 1 then 

7 IF the ANSWER "Y" then 

8 


LEAVE this loop 


9 OTHERWISE 

10 IF the ANSWER IS "N" then 
ll LEAVE this loop 

12 END of test 

13 END of test 

14 END of test 

15 REPEAT this loop 

16 END. , (Task is 3% full.) 


ASK FOR the <l>. (a Function) 


l Does COPY from <1> to TEMP 
2 PROMPT for <l> 
4 LF. the Kl» .. IS .. "s" then 


5 COPY from TEMP to «1» 
6 DISPLAY the «1» 
7 END of test 


8 END (Task is 3% full.) 
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AT line <1> and column <2> display <3>. (a Function) 


1 CURSOR to line <1> and column <2> 
2 DISPLAY the <3> 
End. (Task is 10% full.) 


DISPLAY TITLE of «1». (a Function) 


1 CLEAR the page 

2 OUTPUT from <l> using format "C" 
3 COPY from ACTIVE TITLE to <1> 
End. (Task is 1X full.) 


INCREASE the <1> by <2> (a Function) 


1 ADD the <1> and <2> 
2 COPY the SUM to «1» 
End. (Task is 1% full.) 


OUTPUT COLUMN called <1> using format <2>. (a Function) 


1 OUTPUT from <1> using format <2> 
2 OUTPUT from " " using format 1 
End. (Task is 1% full.) 


ROUND the <1> to <2> -ths. (a Function) 


1 DIVIDE the <1> by <2> 

2 ADD the QUOTIENT and .5 

3 SPLIT the number SUM 

4 MULTIPLY the INTEGER by <2> 
10 COPY from PRODUCT to «1» 
End. (Task is 3X full.) 


SAY this: <l>. (a Function) 


1 CARRIAGE return 
2 DISPLAY the <) 
End. (Task is 1X full.) 


SET the «1» to «42» (a Function) 
1 COPY from <2> to «1» 
End. (Task is 1% full.) 
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REPORT DELETE ERROR (a Task) 


1 RING bell 

2 SAY this: I CANNOT DELETE THE RECORD, BECAUSE I CANNOT 
FIND IT IN THE FILE." 

End. (Task is 1% full.) 


REPORT GET ERROR (a Task) 


1 RING bell 

2 SAY this: I CANNOT GET THE RECORD, BECAUSE I CANNOT FIND IT IN THE 
FILE." 

End. (Task is 1X full.) 


REPORT REPLACE ERROR (a Task) 


1 RING bell 

2 SAY this: "I CANNOT REPLACE THE RECORD, BECAUSE IT IS 
NOT IN THE FILE." 

End. (Task is 1% full) 


REPORT SAVE ERROR (a Task) 


1 RING bell 

2 SAY this: "I CANNOT SAVE THE RECORD, BECAUSE THERE IS ALREADY A RECORD 
IN THE FILE." 

3 SAY this: "WITH THE KEY." 

End. (Task is 3X full.) 


REPORT MATH ERROR (a Task) 


RING bell 

SHOW the SUM 

SHOW the DIFFERENCE 

SHOW the QUOTIENT 

SHOW the PRODUCT 

SHOW the INTEGER 

SHOW the FRACTION 

SAY this: I CANNOT DO THE MATH BECAUSE ONE OF THE ITEMS IS NOT A 
NUMBER," i 

End. (Task is 5% full.) 


0-0 Un E دج دنا‎ — 


iri» ! 
اب‎ 0 
ç i Men ۲ fe My 4 iin 4o — bs 


MA 1 
و‎ i ۱ ۱ up 4 
E ^r dae E ny ۱ oT A me PRIN 


SR TOS 
1 


| AS 


"s 
peo. 
E 


APPENDIX C - WEATHER PROGRAM TASKS 


File WEATHER 


ID 

Item 
Item 
Item 
Item 
Item 
Item 
Item 


Q 


WO YOU Sun — 


LOCATION 
TEMPERATURE RANGE 
PRECIPITATION 
WIND CONDITIONS 
BASIC CLOTHING 
OVERCOAT 
RAINGEAR 

MISC. 


ADD A LOCATION (A TASK) 


1 Does 
2 and 
3 and 
4 and 
5 and 
6 and 
7 and 
8 and 
9 and 


10 and 
11 and 
12 and 
13 and 
14 and 
15 and 
16 and 


START a loop 
CLEAR the page 
"ASK FOR LOCATION 
DECIDE ON BASIC CLOTHING 
DECIDE ON RAIN GEAR 
WHEN folder WEATHER DOES NOT CONTAIN LOCATION then 
SAVE a new page in WEATHER 
OTHERWISE 
SAY this: "LOCATION IS NOT SAVED BECAUSE LOCATION IS ALREADY 
SAVED." 
END of test 
ASK this: "DO YOU WANT TO ADD ANOTHER LOCATION?" 
IF the ANSWER IS NO then 
LEAVE this loop 
END of test 
REPEAT this loop 
Q (Task size is 158 bytes) 
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ASK FOR LOCATION (A task) 


1 Does LIMIT the imput for LENGTH OF PROMPT to a maximum of 25 
2 and START a loop 

3 and ASK FOR the LOCATION 

4 and CARRIAGE return 

5 and DISPLAY the "What is the temperature?" 

6 and CARRIAGE return 

7 and INPUT into ANSWER 

8 and COPY from ANSWER to TEMPERATURE 

9 and CARRIAGE return 

10 and DISPLAY the "What is the precipitation?" 

11 and CARRIAGE return 

12 and INPUT into ANSWER 

13 and COPY trhe ANSWER to WET 

14 and CARRIAGE return 

15 and DISPLAY the "What are the wind conditions?" 
16 and CARRIAGE return 

17 and INPUT into ANSWER 

18 and COPY from ANSWER to WINDY 

19 and ‘CARRIAGE return 
20 and DISPLAY the "Is there any other information you would like to 

save?" 

21 and CARRIAGE return 
22 and INPUT into ANSWER 
23 and COPY from ANSWER to MISC. 
24 and ASK this: "IS THE ABOVE CORRECT?" 
25 and IF the ANSWER IS YES then 


26 and LEAVE this loop 
27 and END of test 

28 and REPEAT this loop 
29 andQ 


CHANGE LOCATION (A Task) 


1 Does CLEAR the page 

2 and ASK FOR THE LOCATION 

3 and WHEN folder WEATHER CONTAINS LOCATION then 
4 and GET the page indexed by LOCATION in folder WEATHER 
5 and SHOW THE LOCATION 

6 and ASK FOR LOCATION 

7 and DECIDE ON BASIC CLOTHING 

8 and DECIDE ON RAIN GEAR 

9 and REPLACE this page in folder 

10 and OTHERWISE 

ll and SAY this: "I can't find that location." 
12 and END of test 

13 and Q 


id 
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DECIDE ON BASIC CLOTHING (A Task) 


1 Does IF the TEMPERATURE is "VERY COLD" then 
2 and COPY from "VERY WARM WINTER CLOTHING" to BASIC CLOTHING 
3 and COPY from "EXTREME COLD WEATHER COAT" to OVERCOAT 
4 and OTHERWISE 
5 and IF the TEMPERATURE is "COLD" then 
6 and COPY from "WARM WINTER CLOTHING" to BASIC CLOTHING 
7 and COPY from "REGULAR WINTER COAT" to OVERCOAT 
8 and OTHERWISE 
9 and IF the TEMPERATURE is "COOL" then 
10 and COPY from "WARM OR SPRING WEIGHT CLOTHING" to BASIC 
CLOTHING 
11 and COPY from "LIGHT COAT" to OVERCOAT 
12 and OTHERWISE 
13 and IF the TEMPERATURE is "WARM" then 
14 and COPY from "SPRING WEIGHT CLOTHING" to BASIC CLOTHING 
15 and COPY from "LIGHT JACKET" to OVERCOAT 
16 and OTHERWISE 
17 and IF the TEMPERATURE is "HOT" then 
18 and COPY from "SUMMER WEIGHT CLOTHING" to BASIC CLOTHING 
19 and COPY from "SWEATER" to OVERCOAT 
20 and OTHERWISE 
21 and IF the TEMPERATURE is "VERY HOT" then 
22 and COPY from "VERY LIGHT SUMMER CLOTHING" to BASIC 
CLOTHING 
23 and COPY from "NON" to OVERCOAT 
24 and END of test 
25 and END of test 
26 and END of test 
27 and END of test 
28 and END of test 


29 and END of test 

30 and SHOW the BASIC CLOTHING 
31 and SHOW the OVERCOAT 

32 and Q 


BEGINNERS ' 
DECIDE 


Does 
and 
and 
and 
and 
and 
and 
and 
and 

10 and 

11 and 

12 and 

13 and 

14 and 

15 and 

16 and 

17 and 


سا دم دیا ج ی O‏ لہ Wo‏ 


DELETE 


Does 
and 
and 
and 
and 
and 
and 
and 
and 

10 and 

11 and 

12. and 

13 and 

14 and 


NO 0 JO Qn £P UD س دح‎ 


MANUAL, APPENDIX C PAGE 4 
ON RAIN GEAR 


IF the PRECIPITATION is "HEAVY" then C 
COPY from "RAIN COAT AND UMBRELLA" to RAIN GEAR 
OTHERWISE 
IF the PRECIPITATION is "MODERATE" then 
COPY from "RAIN COAT OR UMBRELLA" to RAIN GEAR 
OTHERWISE 
IF the PRECIPITATION is "LIGHT" then 
COPY from "UMBRELLA" to RAIN GEAR 
OTHERWISE 
IF the PRECIPITATION is "DRY" then 
COPY from "NONE" to RAIN GEAR 
END of test 
END of test 
END of test 
END of test 
SHOW the RAIN GEAR 
Q 


LOCATION (A TASK) 


CLEAR the page 
ASK FOR THE LOCATION 
WHEN folder WEATHER CONTAINS LOCATION then 
GET the page indexed by LOCATION in folder WEATHER 
SHOW the LOCATION Se 
ASK this: "Do you want to delete this location?" 
IF the ANSWER IS YES then 
DELETE the page indexed by LOCATION from folder WEATHER 
SAY this: "LOCATION DELETED" 
END of test 
OTHERWISE 
SAY this: "I CAN'T FIND THAT LOCATION" 
END of test 


Q 
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DISPLAY THE WEATHER MENU (A Task) 


m 


Does CLEAR the page 


2 and DISPLAY the "For TEMPERATURES between -20 - +10, type VERY COLD, 
between ll - 50, type COLD" 

3 and CARRIAGE return 

4 and DISPLAY the "between 51 - 65, type COOL, between 65 - 75, type WARM, 


between 70 - 90, 

5 and CARRIAGE return 

6 and DISPLAY the "type HOT, and between 91 - 120, type VERY HOT." 

7 and CARRIAGE return 

8 and CARRIAGE return 

9 and DISPLAY the "PRECIPITATION can be DRY, LIGHT, MODERATE, or HEAVY" 
10 and CARRIAGE return 

11 and CARRIAGE return 

12 and DISPLAY the "WIND CONDITIONS can be NONE, GENTLE, BREEZY, and 

STRONG. 

13 and CARRIAGE return 

14 and CARRIAGE return 

15 and CURSOR to line 10 character 31 

l6 and DISPLAY the REQUEST A LOCATION 

17 and SET the LEFT MARGIN to 20 

18 and AT line 12 character LEFT MARGIN display "1, ADD A LOCATION" 

19 and AT line 14 character LEFT MARGIN display "2. CHANGE A LOCATION" 
20 and AT line 16 character LEFT MARGIN display "3. DELETE A LOCATION" 
21 and AT line 18 character LEFT MARGIN display "4. FIND A LOCATION" 
22 and Q 


FIND A LOCATION (A Task) 


Does CLEAR the page 
and ASK FOR the LOCATION 
and BEGIN at page indexed by LOCATION in folder WEATHER 
and GET the page indexed by THIS in folder WEATHER 
and START a loop 
and SHOW THE LOCATION 
and SAY this:*Enter N for next location, P for previous, or Q to quit." 
and LIMIT the input for ANSWER to a mazimum of 1 
and IF the ANSWER IS "Q" then 
10 and LEAVE this loop 
11 and OTHERWISE 
12 and IF the ANSWER IS "N" then 


WOON AUF QÓ N سر‎ 


13 and GET the page indexed by NEXT from folder WEATHER 

14 and END of test 

15 and IF the ANSWER IS "P" then 

16 and GET the page indexed by PREVIOUS from folder WEATHER 
L7 "and END of test : 


18 and END of test 
19- and REPEAT this loop 
20 and Q 
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SHOW THE LOCATION (A Task) 


1 
2 
3 
4 
5 
6 
y 
8 
9 
0 


1 


Does LIMIT the input for LENGTH OF SHOW to a maximum of 75 
and SHOW the LOCATION 

and SHOW the TEMPERATURE RANGE 

and SHOW the PRECIPITATION 

and SHOW the WIND CONDITIONS 

and SHOW the BASIC CLOTHING 

and SHOW the OVERCOAT 

and SHOW the RAIN GEAR 

and SHOW the MISC. 


and Q 


WHAT SHALL I WEAR (A Task) 


1 
2 
3 
4 
5 
6 
7 


Does CLEAR the page 
and START a loop 


and 
and 
and 
and 
and 


and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 


DISPLAY THE WEATHER MENU 
COPY from 0 to CHOICE 
CARRIAGE return 
CARRIAGE return 
OUTPUT from "Please enter the number of your choice" using 
format 80 
CARRIAGE return 
OUTPUT from "or enter Q to quit" using format 80 
LIMIT the input for CHOICE to a maximum of 2 
IF the CHOICE IS "Q" then 
LEAVE this loop 
END of test 
IF the CHOICE IS "1" then 
ADD A LOCATION 
LEAVE this loop 
END of test 
IF the CHOICE IS "2" then 
CHANGE LOCATION 
LEAVE this loop 
END of test 
IF the CHOICE IS "3" then 
DELETE LOCATION 
LEAVE this loop 
-END of test 
IF the CHOICE IS "4" then 
FIND A LOCATION 
LEAVE this loop 
END of test 
REPEAT this loop 


and CLEAR the page 


and Q 
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INDEX 
Aiphanumeric...... 30 
Answer..........-.67-69, 74, 75, 78, 80,:82, 102, 108, 126 
Argument........ .104, 108 
Arithmetic functions 
WE lac o pet 26, 29-36, 48, 59, 105, 108 
DIFFERENCE.......31-33, 103, 134 
1331150۳ 33, 116, 0 
۳۳۷/۱۵۵ 25%: 33, 39, 4, 119, 133 
INTEGER uns. 33, 39, 122, 133 
MULTIBLY. Io... 32-36, 126, 12? 
PRODUCT... Loves 32-36, 126, 129 
OUOTIENT. oos ee 33, 39, 1146, 130 
SNMP u. L SS SS dE Ded 1 
SURTRACT.. oue asi 31-33, 103, 134 
A ie ERAS 28-36, 39, 48, 59, 105, 108 
ASCIRS RE SOS a 61 
ASSIGNED FOLDER.......109, 119 
ASSIGNED ITEM ........109 
ASSIGNED TASX.........110 
e ES MO 87. 111; t13 
Backups 
5 us 17-20 
Diskettes........ 4, 7-10, 42, 54, 85 
COMMANDS: . oe 137 
COMPARISON... 3. 50, 51, 68, 70, 71, 76, 78, 80, 82, 83, 90, 91, 112, 122 
Pd id 68, 75, 7€, hu SR, 85:83, 91, 122 
م9‎ QE nC 50, S1, 68, 75, 78, 82, 83, 91, 122 
IS GREATER THAN..50, $1, 112 
IS GREATER THAN OR EQUAL TO.30, Sl, 112 
IS LESS THAN.....50, Si, 112 
IS LESS THAN OR EQUAL TO....50, 51, 2 
TS NOT... i... Sq, 51, 68. 9, 7$, 80, 112 
01 I... 1. u S 70, 71, 112, 138 
CONTAINS..........- 70, 71, 88, 112 
CONTAINS GREATER THAN.70, 71, 112 
CONTAINS LESS THAN...70, 71, 112 
DOES NOT CONTAIN.70, 71, 112 
WHOIS ES sis 70; 21,7112 
UE IU E DC DIETE 2, 10, 12, 14-20 
ERIMC TE 8 ts chars 23 
Dsbault. ceo bero 91,97, 113, 124 
DEUIMITER............ 86, 07, 182, 114, 120 
0188618 oer 2-4, 8-10 
۳0160۳20 ors 2-4, 8-10 
Disk memory...........2. 6 
EDIT commands 
Dz. O 225 407567684108, 88,591,502, 97, 98,15 
Laymi A _. .37, 40, 48, 56, 68, 76, 88, 89, 91, 96, 116 
line number...... 37-40, 56, 68, 79, 87, 88, 116 


Q; و اوه‎ E 37, 38, 40, 41, 52, 59, 64, 76, 79, 80, 84, 88, 89, 103, 116 
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ELEMENT. ..............25-32, 41, 44, 45, 50, 85-87, 91, 116 


NEE ON iene os E Cs 42, 75, 76, 91, 116, 124, 127 
DNI teres oA A tac 36, 49, 76, 78, 80, 82, 102, 116 
ESCAPE key............ 6, 11, 26, 27, 93, 116 
RA CE AS 6, 26, 27, 53, 
Rec rens RV 6 
S .6, 33 
DLP QUITE cite oss es 2 
112152] ARA 56ers 61-107, 118, 137 
A AR 92, 93 
CREATE. Loos. 99; 313 
DICTIONARY....... 61, 62, 137 
DIRECTORY........62-64, 66, 71-73, 76, 78, 79, 82, 83, 85, 87-89, 103 
BOLT AA A 64 
1U feit cmo A 61-63, 65, 70, 71, 76, 77, 85, 87, 88, 92, 122, 127 
i SAER e 62, 66. 72, 76, 85, 122 
FASES. iY rene 61, 73, 75, 76, 127 
Wema... nl T t. 95,92, 319. 129 
REELS 22, 24, 25, 45, 119 
FRONT o MOO REE P3097 31$. 498 7127 
Mara CODY): e 58, 101, 103 
INCREMENT. lL ran 104-106 
IO... تاه رد‎ urs 25, 28, 108, 3 
Left arrow ۰ $ 
a O ee ae it 85-87, 103, 113, 124 
LENGTH: OF. PROMPT....... 66, 124 
LENGTH OF SHOW........ 42, 66, 124 
CETERAE: I u تیب و‎ 22, 39, 40, 48, 62, 65, 125 
AUR T ako dt rea 48, 49, 64, 73, 82, 125 
hiis 0o O AUS ee see diskette 
No ee veces kee 9, 11, 12, 14, 30, 126 
LISTO MERITIS TTE E ?, 11, 14 
Na occ Ene coms ?, 11, 12, 14, 30, 126 
hU DO TTE OPES 25 
| A 76, 91, 124, 127 
A AS AA 99, 100 
PERSONAL LANGUAGE..... 21 
Bigition. AN es 73, 89, 121, 128 
A Rare ae 73, 89, 121, 128 
AN EIT 73... 121, 128 
NEST Les 73,. 74, 89, 121, 128 
PREVIOUS I ......., 73, 79, 121, 128 
SEIU soc ARIS 73, 121, 128 
BRIMARIES.  . u. a 137 
A Brn N YM SY 35, 37-41, 52, 57, 59, 64-66, 69, 72, 73, 76, 79, 80, 82, 83, 88-90, 101, 103, 
105, 116 
A E Rte: 9, 8, 11, 14, 33, 38, 50, 54, 66, 85 
Ready message.........8, 26, 43, 46, 53, 66, 75, 76 
ROE a A nes 137 
Reset key. ....1. s. 
REBIBUEL V. aT ete 107, 130 
RETUBN B. icio» ec 5, 7,13, 14; 24 35, M, 122 


Right arrow key....... 6 
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ROBOT PROGRAMMER...... 64, 86, 114, 120, 132 
Dl E E ta 98, 123 
SAVIA RO ad oe 


SAVVY BACKUP UTILITY. .17-20 
Standby tasks 


ARCHIVE..........8-10, 26, 42, 54, 85, 108, 112, 134 
CONFIGURATOR.....3, 11-17, 26, 58, 108, 112, 115, 134, 137 
DIAGNOSTICS...... 25, 26, 108, 112, 115, 134, 137 
BUMMON. .. 1 8, 11, 14, 16, 26, 42, 43, 108, 112, 115, 134 
Startup message.......7, 10, 13, 16, 17, 26 
PEED EAE 
A A der 34-107, 135 
ADD TO THE BILLS FOLDER...... 93, 94 


ADD TO THE DIRECTORY FOLDER. .66-70, 76, 102 
CHANGE THE DIRECTORY PAGE...82-84, 102 


COUNT Con 48-53, 57, 106 

CREATE A PAGE ID FOR BILLS. .93 

CREATE A PAGE ID FOR DIRECTORY........ 6, 67, 70-72, 87, 88 

DEFINE sh 22, 34, 39, 48, 54, 65, 66, 73, 73, 77, 80, B2, 89, 95, 113, 120 
BEDAE. a on ie E 36, 37, 89, 99 

EDIT.............37-39, 58-60, 66, 70, 87, 96-98 

ENTER A BILLS PAGE...... 93 


ENTER A DIRECTORY PAGE. .64-68, 83 
FIND A PHONE NUMBER..... 80-82, 84, 88, 89 


GREETING. xu ssa 34-59, 100 

HI ERST TASR O6... 38-39, 12, 97 

MY SECOND TASK.......... 39-42, 44-47 

PRINTOUT IRR... C... 9% 

PRINTOUT THE DIRECTORY FOLDER.......... 89-91, 92, 96-98 
REMOVE THE DIRECTORY PAGE.............. 77-80, 83-85 


REPORT ASSIGN ۰ 137 
REPORT DELETE ERROR..... 39, 137 


REPORT GET ERROR........59, 81, 137 

REPORT MATH ERROR....... 26, 59, 60, 108, 137 
REPORT REPLACE ERROR....59, 137 

REPORT SAVE ERROR....... 39, 137 

BIARDUP. o s S ers 14, 16, 26, 60, 137 


SHOW THE BILLS FOLDER...>4 
SHOW THE DIRECTORY PAGE.72-74, 78, 83 


SHOW THE DIRECTORY FOLDER. 2055's. 3... <0 73-77 
Temporary memory............. 35, 65, 66, 128 
OBR UT T EE TA sN 25, 30 
WIDER: ENHANCER. ro 11, 14 
VINES: VIDEOTERM. J U 2 aira hyde ME 11, 197 16; 106138 
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VOCABULARY APPENDIX 


ADD ; 
ADD the (ELEMENT) and (ELEMENT) 


C The specified elements are added together, and the result is stored in the item SUM. 


The elements may be numbers that you type in when you tell SAVVY to add one thing to another, or they may be 
the names of items that contain numerical values. (For example, you may tell SAVVY to add 1 to the answer it 
just got from another calculation.) SAVVY looks in that ITEM and adds 1 to whatever it finds there. If you 
inadvertently tell SAVVY to add a number to NAME, and NAME has the word 'Fred' instead of a number stored in 
it, SAVVY will report that you are telling it to add a number to a word and that it can't do that. Also bear 

in mind that SAVVY recognizes the numbers below as being the same. 


1496 "1496" 1,496 "1,496" 


I there is an error, SAVVY will make the contents of the item SUM, ERROR, and will ezecute the task REPORT 
MATH ERROR. 


ANSWER 


This is a standard item put in memory at the factory. SAVVY will not do anything with ANSWER until you tell it 
what to do. It can be used as the item in which to put the input from a question that SAVVY asks. 


ARCHIVE 


ARCHIVE is the name of a ‘standby task' that allows you to copy the information on a diskette. The ARCHIVE 
commands are not automatically transfered to the computer when the system comes up, because you typically use 
ARCHIVE only once or twice during a working session, and you don't want to use active memory to store it. When 


you want it, you use the command SUMMON. You SUMMON the standby task ARCHIVE and follow the displayed 
instructions. (See SUMMON) 


NOTE: Although ARCHIVE is a task, its name is listed as an item instead of as a task. This is done 


because it is a standby task, and not a task on the DATA disk. This is also true of the other standby tasks 
DIAGNOSTICS and CONFIGURATOR. 


C ARGUMENT 
An argument is a place in a FUNCTION where a value will be inserted later. For example, in the function: 
INCREMENT the (1) 


The (1) is an argument. 


It lets SAVVY know that when you use the function, you will enter the proper 
information instead of (1). 
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ASSIGN 
ASSIGN the "(TASK, STRING, or ITEM)" to ASSIGNED TASK, ASSIGNED FOLDER, OR ASSIGNED ITEM 


This tells SAVVY to run the specified task when the ASSIGNED TASK is called for; or to use the folder named by 
the string when the ASSIGNED FOLDER is called for; or to use the ASSIGNED ITEM named in the string or named in 
the specified item. 


You are not likely to use this word unless you are engaged in fairly advanced work, probably teaching SAVVY 
how you want it to do a new type of automatic programming. 


Your purpose would then be to describe for SAVVY a task that works with other tasks or with different folders. 

You can't name all of those other tasks or programs at the moment, but you use the name ASSIGNED TASK, 
ASSIGNED FOLDER, or ASSIGNED ITEM where the specific names would be used. SAVVY understands that you will 
provide (or SAVVY will provide) the names of the real tasks or folders to use when they are needed later. 
Meanwhile, you are able to describe and test the entire task, using ASSIGNED TASK, ASSIGNED FOLDER, or 
ASSIGNED ITEM as a dummy in Place of the real thing. When you want to use the real thing you ASSIGN it to 
ASSIGNED TASK, ASSIGNED FOLDER, or ASSIGNED ITEM without having to rewrite the whole thing. In fact, you can 
make a whole series of different tasks and folders very quickly. 


When you type in the task, item, or folder you are going to ASSIGN, you must use the beginning quotation mark. 
That way SAVVY knows exactly what to ASSIGN. 

ASSIGNED FOLDER 
This is a standard item that contains the name of a folder to be used when you use the item name ASSIGNED 
FOLDER. For example, the task that shows the information in a folder can be used to show the information from 
more than one folder if you use ASSIGNED FOLDER instead of the folder name. When you want to use it on the 
first folder, just ASSIGN the first folder's name to ASSIGNED FOLDER. Then do the task that shows the 
information. When you want to use the task to show the information from the second folder, ASSIGN the second 
folder's name to ASSIGNED FOLDER and then do the task to show the information. 

ASSIGNED ITEM 


This is a standard item that contains the name of another item that will be used when the item ASSIGNED ITEM 
is used. For example, if the contents of ASSIGNED ITEM is NUMBER OF PAGES IN SOURCE, you could tell SAVVY: 


SHOW the ASSIGNED ITEM 
It would respond: 
NUMBER OF PAGES IN SOURCE is 10 


You could ASSIGN any other item to ASSIGNED ITEM, and if you were to SHOW the ASSIGNED ITEM, SAVVY would 
show whatever was ASSIGNED to ASSIGNED ITEM. 


Page 0 


ASSIGNED TASK 


This is a standard item that contains the name of the task that will be executed when you use the command DO. 


When you ASSIGN a task to ASSIGNED TASK, and then tell SAVVY to DO the assigned task, it will do the task that 
is in ASSIGNED TASK. 


ASSOCIATE 
ASSOCIATE new phrase (NEW PHRASE) with old (OLD PHRASE) 


This tells SAVVY that the new phrase 'means the same thing' as the old phrase. For example: 


ASSOCIATE new phrase REPO with old DUPLICATE 
ASSOCIATE new phrase DS with old DISPLAY 


NOTE that these new phrases are more than synonyms. If SAVVY sees anything like either the old or the new 
phrase, it can respond sensibly to what it sees. You can ASSOCIATE any existing task name, item name, or 
folder name with any new phrase. You may find the existing SAVVY vocabulary very limiting, and the usages very 
odd. If you don't like what exists, teach SAVVY your own words and phrases for the same things. As you teach 
SAVVY new tasks, you will be using your own descriptive names anyway. SAVVY will automatically learn your 


manner of expression from you...and will be able to handle increasingly complex concepts. This is where a 
great deal of SAVVY'S power resides. 


Important: As you actually use SAVVY, you will develop a large body of phrases that are not typical of 


traditional computer usage. For example, if you choose to have SAVVY keep up your ADDRESS BOOK (perhaps you 
call it CONTACTS LIST), the system can automatically generate a series of programs that ask you for the 


information that is to be kept in the book. When you want to get information out, you will ask SAVVY questions 
about the contents of the book. 


Whose phone number is 559-555-1212? 
What company does Bill Jones work for? 


SAVVY must know how to identify and get the information you are requesting. In certain cases, SAVVY will write 
the necesary tasks for you automatically. In other cases, you will work them out for yourself, or use tasks 


written for you by somebody else. However they are developed, these tasks will have names, sometimes in the 
form of questions. For example: 


What is the company connection of person X in (City, State, or Country)? 


That is a clumsy question, and you may want to ASSOCIATE three or four more likely alternatives with it. That 
way, no matter how you phrase your questions when you need to know about X's employer, they will be close 
enough to something SAVVY has seen before to let the system take the appropriate action. You can also 
ASSOCIATE a word or phrase to an association that you have already made. Oddly, SAVVY can't ASSOCIATE a number 
with a name. To get rid of associations, see FORGET. You can get a listing of all of the associations that 

have been made, by typing in: 


LIST the ASSOCIATIONS 
You can also get a listing of the associations and what they are associated to by typing in: 


DETAIL the ASSOCIATIONS 
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BACK 


This is a word for you. It is the name of the item where SAVVY stores the right hand portion of a CUT or TAKE. 


For example: 
TAKE this many characters 3 from "ABCDEFG" 
SHOW the BACK 
BACK is DEFG 


See CUT and TAKE. 


BEGIN 
BEGIN at page indexed by (ID) in folder (FOLDER NAME) 


This sets the starting point for subsequent GET'S from the folder named. 
You may want to get the addresses of everybody with the zip code 94086 from the folder called CUSTOMERS, and 
SAVVY has already looked through that alphabetical listing up through the R's. When you start the search 
again, you want it to begin with the next letter so you say: 
BEGIN at page indexed by "S" in folder CUSTOMERS 
Very commonly, when you want to leaf all the way through a folder, looking at every page, you will tell SAVVY: 
BEGIN at page indexed by FIRST in folder CUSTOMERS 
(then do this and this and this... .) 
See also POSITION. 


CARRIAGE 
CARRIAGE return 


This tells SAVVY to drop down to the next line while displaying or printing text and begin at the first 


position on that line. This is like a ‘carriage return' on a typewriter. The use of CARRIAGE will be a habit 
that you will develop quickly. 


CLEAR 
CLEAR the page 


This word tells SAVVY to clear the screen as if it were ejecting a piece of paper from a typewriter. The 
screen is emptied, and the prompt 'What would you like me to do now?' appears on the first line of the clean 
screen. CLEAR also ejects a page from the printer if the system is set for printing. 
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ZOMPARISON 


This word by itself means nothing special to SAVVY, unless you teach it a meaning, but the word is used in 
some of the definitions of the other vocabulary terms. The comparisons that SAVVY recognizes are: 


IS IS GREATER THAN OR EQUAL TO 
IS NOT IS LESS THAN OR EQUAL TO 
IS GREATER THAN IS LESS THAN 


They will be used in conjunction with the command IF. To use any one of them, you must type in the whole 
comparison before pressing the RETURN key. 


CONFIGURATOR 


The CONFIGURATOR is a standby task. It enables you to tell SAVVY the characteristics of your particular Apple 
system so that SAVVY knows what it can do, and what it can't. To use CONFIGURATOR, you SUMMON the standby task 


CONFIGURATOR. Once the task has started to run, it must run to completion. You cannot get out of this task 
using ESC. 


NOTE: Although CONFIGURATOR is a task, its name is listed as an item instead of as a task. This is also true 
of the other standby tasks DIAGNOSTICS and ARCHIVE. 


ZONTENTS 


This word is very similar to the word COMPARISON. It has no special meaning to SAVVY, but it is used in the 
definition of some other vocabulary words. The contents descriptions that SAVVY recognizes are: 


CONTAINS CONTAINS GREATER THAN 
DOES NOT CONTAIN CONTAINS LESS THAN 


They will be used in conjunction with the vocabulary word WHEN. To use one of these CONTENTS you need to type 
in the whole thing before pressing the RETURN key. 


COPY 


COPY from (ELEMENT) to (ITEM) 
This tells SAVVY to copy the contents of a specified ELEMENT to the specified ITEM; or to copy what you type 
in quotation marks into the specified ITEM; or to copy a specific number into the specified ITEM, replacing 
anything that was in there. For example, if you type: 
COPY from 6 to REQUESTS 


SAVVY will replace whatever value is in REQUESTS with the number 6. If you type: 


COPY from REQUESTS to REPLIES 


Then SAVVY would replace the contents of REPLIES with the contents of REQUESTS, which in this case is the 
number 6. Now you could also type: 


COPY from "computer" to REPLIES 


t 
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In this case SAVVY would replace the contents of REPLIES with what you typed in quotation marks, which would 
be the word "computer." 


CREATE 


CREATE a folder called (FOLDER NAME) 


This tells SAVVY that you want to describe the contents and order of a new file folder. SAVVY asks the name of 
the folder you want to CREATE, asks what item Names you want to put on each page of the folder, and asks how 
you want it indexed. SAVVY keeps track of the folder names that you have used and will not let you use a name 


that has already been used. It will not let you use the name of an item or the name of a task that is already 
in use either. 


CURSOR 


CUT 


The cursor is the indicator on the screen which shows you where the next typed entry will be displayed. 


CURSOR to line (NUMBER) and character (NUMBER) 


The command CURSOR tells SAVVY to put the cursor at a particular place on the screen. It marks the spot at 
which characters will begin to appear when you start typing again. For example, in doing a task you might want 
to move the cursor away from the position where it had stopped. You could tell it to go to line 10, character 
15. That would put the cursor at line 10 and character 15 and the next character that you typed would appear 
right there. On the NATIVE Apple display there are 24 characters across the screen and 24 rows down. Using the 
VIDEX card will give you 80 characters across and 24 rows down. The coordinate for the first position on the 
screen (the upper left corner) is line 0 and character 0. If you use a number that is larger than the maximum, 
SAVVY treats it as the mazimnum. If you use a negative number (like -6) SAVVY only recognizes the numeric 
portion. It will not recognize the minus symbol. 


CUT the (ELEMENT) after (ELEMENT) 


This tells SAVVY to split the specified element into two parts after a specific character. The left-hand part 

is stored in the item FRONT. The tight-hand portion is stored in the item BACK. In addition to this, the 
number of characters in FRONT is stored in the item LENGTH. For example say that you have the name of a 
customer stored in the item-CUSTOMER NAME as Jones,Frank. To address something to this customer you would need 
to change the name around. The first step you would take would be to CUT this CUSTOMER NAME after nan. That 
would put ‘JONES,' in the item FRONT and FRANK in the item BACK. Then you would go on and do some other steps 
to rearrange the names. It is VERY IMPORTANT to note that you must use the quotation marks when specifying the 
element after which you want to CUT . That shows SAVVY what to look for. If you didn't use the quotation 
marks, SAVVY would try to use the value of the element. CUT is also similar to the vocabulary word TAKE. But 
only similar. CUT does the splitting after a specific character, while TAKE does the splitting after a 
specific number of characters. 


( DEFAULT 


This is a format that is given to SAVVY at the factory. IT is used with LAYOUT and OUTPUT. It sets the format 
to the length of the contents of the item specified. For example, in the folder CUSTOMERS, on the first page 
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the item LAST NAME contains JOHNSON, and on the second page the item LAST NAME contains SMITH. If you had a 


task that went through the folder and printed all of the last names using these two steps: 
LAYOUT the LAST NAME using format "5" 
DISPLAY the LAST NAME 

SAVVY would respond by showing you: 


SMITH 
JOHNS 


One way to get SAVVY to print the entire contents of the item, would be to use the format DEFAULT. In the 
above example, SAVVY would show: 


SMITH 
JOHNSON 


The way this happens, is that SAVVY uses the length of the contents of the item as the format. 


DEFINE 
DEFINE a task called (TASK NAME) 


This tells SAVVY to define the work of a computer program that SAVVY will afterward write for you. SAVVY will 
then ask you, step by step, what you want the task to do, prompting you for the information it needs. 


DELETE 
DELETE the page indexed by (ID) from folder (FOLDER NAME) 


This tells SAVVY to remove the specified page from the specified folder. The ID that is used may be the 
specific ID in the folder, an item that contains the ID, or a position in the folder. SAVVY will only use 

DELETE to remove a page from a folder. It will not use this word to remove an item or folder or association. 
Refer to ERASE, FORGET, and RENAME. 


DELIMITER 


This is a term meant for you. It is not a command that SAVVY recognizes, but it is an item that SAVVY 
recognizes. It is used at times in conjunction with the commands PASTE and CUT. The content of DELIMITER is "\ 
". This symbol is used between two things that you may want to CUT later. In this way you have a specific 
character at which to do the cutting. The delimiter is also used by the ROBOT PROGRAMMER when you use it to 
write the tasks for you. To type the DELIMITER, press the CTRL key and the L. 


DETAIL 
DETAIL the (TASK NAME or FOLDER NAME) 


This tells SAVVY to show the steps of the specified task or the structure of the specified folder. If you tell 
SAVVY to DETAIL the (TASK) it will show you the steps of that task in the order that it is supposed to be 
done. It shows this to you the way that you or someone else put it into the computer. It will not show the 


t 
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codes in which it gives these steps to the computer. If you believe these steps are wrong, then you can change 
them using the command EDIT. Please note that SAVVY cannot show you the steps of a task that has been SECURED. 


SAVVY's primary vocabulary is SECURE. You can detail the following: a specific task, a specific folder, 
associations, tasks, folders, and undefined names. 


DIAGNOSTICS 


DIAGNOSTICS is a standby task that tests your computer system when you suspect that you have a problem, and 
reports it to you. To use DIAGNOSTICS, you SUMMON the standby task DIAGNOSTICS. Since DIAGNOSTICS does no: 


give you a screen image that remains when it is through, it is a good idea to select PAPER before running 
DIAGNOSTICS. Then you will have a hard copy of the report. A good DIAGNOSTICS will look like this: 


SAVVY Diagnostic 


Computer: ok 

Media: ok 

Fixed assigns: ok 

Objs: ok 
Missing: ok 

Obj uses: ok 
Savvy: ok 
Dict: ok 
Orphans: ok 

System disk: ok 


NOTE: Although DIAGNOSTICS is a task, its name is listed as an item instead of as a task. 


This is true of 
the other standby tasks also. 


DISK TITLE 


This is a standard item that contains the title of the current DATA disk. The DISK TITLE for a 'clean DATA 
disk' created with the CONFIGURATOR is: 


An Original SAVVY(tm) working disk 


DISPLAY 
DISPLAY the (ELEMENT) 


This tells SAVVY to display on the screen whatever you have specified. If you have typed in a string of 
characters in quotation marks, it will show exactly what you typed in. If you tell it to DISPLAY an item it 
will show the contents of that item. SAVVY will only show the contents of an item; it will not show the item 


and its contents together. To get SAVVY to do that, you need to use the command SHOW. An example of DISPLAY 
is: 


The item REQUESTS contains the number 45. If you type in: 
DISPLAY the REQUESTS 


SAVVY responds by displaying 45. If you type in: 
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DISPLAY the "REQUESTS" (note the quotation marks) 


SAVVY responds by displaying REQUESTS. 


DIVIDE 
DIVIDE the (ELEMENT) by (ELEMENT) 


This tells SAVVY to divide the first element by the second element and to store the result in the item 


QUOTIENT. If you try to divide by zero, or get an answer too long to be handled by the system, SAVVY will tell 
you about the problem. 


DO 
DO the assigned task 


This tells SAVVY to do whatever task has been assigned to the ASSIGNED TASK. 


DUPLICATE 
DUPLICATE this screen 


This tells SAVVY to print whatever is on the screen at the moment. This is very simple and very useful. It 
tells SAVVY to turn on the printer and to copy whatever is on the screen. Ç 


EDIT 
EDIT the (TASK NAME, FOLDER NAME, or FUNCTION NAME) 


EDIT tells SAVVY that you want to make changes in a task, a folder, or a function that has already been 
defined or created. The EDIT command also has some special commands that help you in your editing. They are: 


L--This tells SAVVY to LIST all of the steps in the task 

D--This tells SAVVY to DELETE the line right above the present position of the cursor 

Q--This tells SAVVY that you want to quit editing the task and that SAVVY is to record 
the changes on the disk 

(line number)--This tells SAVVY to go to a specific line number 


In editing a task, you can move around freely in the task by using the line numbers. That is not the case in 
editing a folder. When you edit a folder, you are brought to the last line of the folder; and if you want to 
make a change in a line before that line, you must delete all of the lines up to the line that you want to 
change. Then you can make your change and retype all of the lines that were deleted. It would be a very good 
idea before editing a folder to DETAIL the folder on paper so that you will be sure to enter them the same way 
when you retype them. A folder must also be empty before you can EDIT it. 


Remember, when you have finished editing the task or folder,you use Q and not ESC. That way the changes are 
recorded on the disk. SAVVY cannot edit a task or folder that is secure. 
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ELEMENT 


This is a word for you, and means nothing special to SAVVY. An ELEMENT is a 'string, an item, or a number.' 
It's just more convenient to say ELEMENT than to say 'string, item, or number.' A string is a series of 


characters (text, numbers, or symbols). The way to tell SAVVY that you are giving it a string, not an 
instruction, is to enclose it in quotation marks. 


EMPTY 


This is a standard item that contains an empty string. If you want an item to have a content that is empty, 
then you can copy EMPTY to that ITEM. 


END 
END of test 


This tells SAVVY that it has come to the end of an IF test or a WHEN test. SAVVY has to be told explicitly 
when the END of a test has been reached in a task. SAVVY is willing to accept a series of IF's or WHEN's 
before ending the test, but the price is that you have to say when the test is finished. Tor example: 


0 --- Task called DEMO END 
1 Does IF the PRICE IS 3.00 then 


2 Do IF the SIZE IS NOT 6 then 
3 Do ORDER SOME 
4 and END of test 


5 and END of test 
6 and END (task is 1% full) 


In this case, we have used IF to test for two conditions, price and size, before ending the test. We could 
test for many conditions--more than makes practical sense--before ending the test. If things become so 
complicated that SAVVY cannot follow them, it will stop and display an ERROR message. If you forget to end a 
test when you are defining a task SAVVY will remind you and ask you to fix it before it will let you complete 
the definition of the task. It does this with the ERROR message: 


Unfinished LOOPs,IFs, or WHENs remain! Please correct them! 


To correct it, insert the command END in the proper place. 


The word END is also added to the last line of a task when you press Q. In this context, it tells SAVVY it has 
come to the last instruction in a task. 


ERASE 
ERASE all pages in folder (FOLDER NAME) 


This tells SAVVY to remove all of the pages in the specified folder. It only applies to pages, not to items or 
to folders. 
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FILL 
FILL folder (FOLDER NAME) from (FOLDER NAME) 


This command tells SAVVY to copy the structure of the first folder into the second folder. This is best 
explained by an example. In this example, the first folder will be called customers. If you were to DETAIL the 
CUSTOMERS folder, it would look like this: 


CUSTOMERS 


ID CUSTOMERS ID 

Item CUSTOMERS LAST NAME 
Item CUSTOMERS FIRST NAME 
Item CUSTOMERS ADDRESS 
Item CUSTOMERS PHONE 


Cn ص‎ Ç وج‎ — 


The second folder is caled SAMPLE FOLDER. It just uses the letters ID for the ID of each page and has no other 
items on the page. If you were to type: 


FILL folder SAMPLE FOLDER from CUSTOMERS 


Then: 


LIST the INDEX of folder SAMPLE FOLDER 


SAVVY would show you: 


INDEX of folder SAMPLE FOLDER 
Page ID 


1 "CUSTOMER ID" 

2 "CUSTOMER LAST NAME” 
3 "CUSTOMER FIRST NAME" 
4 "CUSTOMER ADDRESS" 

3 "CUSTOMER PHONE" 


This command will be one that you will not use very often, unless you are doing some advanced programming, or 
designing another ROBOT programmer. 


FOLDER 


SAVVY does not have this word in its primary vocabulary, although it appears in many of the responses SAVVY 
shows you on the screen. When you and SAVVY deal with real folders, however, you refer to them by their names, 
so the word itself has no direct meaning to SAVVY...ezcept in the special case that will be discussed a few 

lines after this. A folder is the equivalent of a file folder--a familiar old manila folder full of pages that 

contain information. In concept, the folder name is written on the tab that sticks up above the back flap of 

the folder. When you tell SAVVY to get a folder, by name, it is as if SAVVY goes to a filing cabinet, opens e 
the drawer, and takes this folder out for you. SAVVY knows a lot about filing systems and needs only the 

folder name to find what you need. You don't have to specify which filing cabinet or which drawer is wanted. 
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THE SPECIAL CASE: SAVVY knows the term ASSIGNED FOLDER. You can ASSICN any folder by name to ASSIGNED 
FOLDER.(See ASSIGN.) You are not likely to do this unless 


you are developing new automatic programming tasks 
with SAVVY. 


FORGET 
FORCET the phrase (ASSOCIATED PHRASE) 


This tells SAVVY to forget an established association. It does not affect the original phrase with which this 
phrase is associated, hence does not alter the performance of any task or the content of any item or folder. 
This also does not affect any other associations that you may have made to the association that you are 
telling SAVVY to FORGET. For example: 

Say that you have made the following associations: 


ASSOCIATE new phrase WIPE with old CLEAR the page 


ASSOCIATE new phrase CS with old WIPE 


Now that you have done that, you find that you are using CS and not WIPE; you can tell SAVVY to FORGET WIPE, 
and it will not affect CS at all. 


FORMAT 


FORMAT is not part of SAVVY's primary vocabulary, but it refers to the form in which information is to be 
presented by SAVVY. See LAYOUT. 


FRACTION 


This is a standard item that contains the decimal portion of a number that has been SPLIT. 


FREE 
FREE... I'll use my best judgment 


This is the mode in which SAVVY will try to help you by examining what you type and comparing it with what it 
knows. It will try to understand misspelled words and will make associations from what you enter. It is the 
opposite of LITERAL 


FREEZE 
FREEZE the (ITEM, TASK, FUNCTION or FOLDER) 


This tells SAVVY to fix the current value, structure, or contents of an item, task, function, or folder, so 
they cannot be changed by ordinary methods. Suppose you create an item called FICA RATE and you put the 
current value of .067 there. Now you do not want this to be changed easily, so you FREEZE this to keep this 
value constant. When you want to change the contents, you use the command THAW. 
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FRONT 


This is not a command for SAVVY, it is an item that SAVVY uses. SAVVY stores the left hand portion of a CUT or 
TAKE in the item FRONT. SAVVY also stores the results of a PASTE in FRONT. See CUT, TAKE, and PASTE. 


FUNCTION 
FUNCTION called (FUNCTION NAME) 


This tells SAVVY that you want to define a special type of task called a FUNCTION. This is a tool for use in 
advanced applications work. Instead of typing DEFINE to begin the description of the task, you type FUNCTION, 
and SAVVY begins the work of definition with a preliminary step that lets you specify variables and prompts 

for them. 


An important note: When you are defining functions, you create prompts that appear on the screen. Those 
prompts can be in any language that you choose, within the limitations of the keyboard and the character 
display available on your computer. If you are actually a skilled programmer, and this stuff is all a piece of 
cake to you, you can easily set up the entire SAVVY system to operate in languages other than English, 
associating words and phrases in the other language with the words and phrases in English. The casual user of 
this system, straining to remember a few words of the preliminary vocabulary, won't be doing anything this 
elaborate for some time to come, but experienced programmers can develop major applications packages 
astonishingly fast with SAVVY'S help. FUNCTION is a powerful tool for this purpose. 


GENERATE Ç 
GENERATE from folder (FOLDER NAME) then halt 


GENERATE takes information from the specified folder as if it were being entered from the keyboard, and 
defines tasks using that information. GENERATE is a critical element in automatic programming. 


You are unlikely to be using GENERATE unless you are a skilled programmer designing a new automatic 

programming task. To understand its use, DETAIL and examine the tasks that call the ROBOT PROGRAMMER provided 
on the DEMO DISKETTE. By way of guidance--those tasks assemble information from various sources--your keyboard 
input, the primary vocabulary, stored data, operating system commands and prompts--whatever is relevant. The 
assembled material is put in folders that the system creates for the purpose, in sequence. GENERATE then takes 
the sequential units of information from those folders and writes step-by-step tasks in standard form, using 

the information. Once it starts, GENERATE runs until it has completed all its scheduled tasks or until it 

finds some problem and asks for help. 


To do an example of a task that uses GENERATE , DEFINE the following task on a copy of the DEMO disk: 
GENERATE EXAMPLE 


1 Does ERASE all pages in folder SOURCE 

2 and COPY from 1 to SOURCE ID 

3 and COPY from "PAPER\LIST\ITEMS\PAPER\LIST\TASKS\" to source ID 
and SAVE new page in SOURCE 

and GENERATE from folder SOURCE then Halt 

and END 


os Cn n 


GENERATE interprets the DELIMITER as if it were a RETURN. 
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Do this task and you can get an idea of how GENERATE can help in your programming.This task will give you a 


printed list of the items and the tasks on the DEMO disk. You could do what this task does by typing the 
following four steps: 


PAPER(R) 
LIST(R) ITEMS(R) 
PAPER(R) 
LIST(R) TASKS(R) 


GET 
GET the page indexed by (ID) in folder (FOLDER NAME) 


This tells SAVVY to retrieve specific information from a specified place. The ID used might be the ID of the 
page, an item whose content is the page ID, or one of these identifying terms: FIRST, NEXT, THIS, PREVIOUS, 
LAST. For an explanation of these terms see POSITIONS. 


GO 
GO to the line called (LABEL NAME) 


This tells SAVVY to jump from where it is to another line in the task and start working from that point. If 
SAVVY doesn't find the specified line it reports the fact. Using GO, you can tell SAVVY to move around freely 
inside a program it writes, instead of just working through it in order from beginning to end. If you have had 
little or no computer experience, you should be careful in using GO and LABEL, because things can easily 
become confusing as you try to follow the path that SAVVY takes in doing a task that uses many CO statements. 
The LABEL NAME needs to be entered in quotation marks, because SAVVY is expecting a string. 


HALT 
HALT and return to Ready 


This tells SAVVY to terminate the program it is running and return immediately to the 'What would you like me 
to do now?' message. Ordinarily, you will use HALT with an IF or a WHEN. For example, if SAVVY is running a 
PAYROLL, and the total amount of the checks written doesn't balance with the other calculations, then 
something is wrong. You don't want SAVVY to continue working until this is straightened out. So you would 
include an instruction something like this: 


IF the TOTAL CHECKS IS NOT TOTAL PAYROLL then 
HALT and return to Ready 
END of test 


SAVVY won't go on with the task (which might involve giving bad information to the General Ledger, the Journal 


and various reports), but will halt in its tracks, letting you correct any error at this relatively harmless 
level. 


ID 


IF 
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The ID is the reference name or number of a page in the folder. It is derived from identification and is a 
term from everyday use. 


IF the (ELEMENT) (COMPARISON) (ELEMENT) then 
(TASK NAME) 


This tells SAVVY to compare the first element with the second element using the specified comparison. Refer 
back to the explanation of COMPARISON in this section if you need to refresh your memory on that subject. If 
the comparison is true, then SAVVY will execute all of the steps between the IF and the END (of test) 
instructions. If the comparison is not true, then SAVVY will skip over all of the instructions following the 

IF until it reaches the first instruction after the END (of test). Processing resumes with that instruction. 
Keep in mind that only if the comparison is true, are all of the instructions between the IF and the END (of 
test) executed. If the comparison is false, all of the instructions following the IF through the END (of test) 
are skipped over. 

Several concepts with which SAVVY deals are difficult to gtasp. IF is one. WHEN is another. SAVVY has been 
taught to respond with prompting words when you use any of the primary commands. While it is possible to 
Provide prompts at every point in IF, it has proved impractical to provide the prompts and fit everything on 
one line. If SAVVY were to use slashes, periods, or other symbols instead of words, to indicate where to type 
your information, the line would look too "computerish" and would not gain clarity. So you need to study the 
examples in this manual to help gain the understanding you will need. 


INDEX 


An INDEX is a list of the ID's in a folder. You may say LIST the INDEX of (FOLDER NAME), and SAVVY will list 
the ID of each page in that folder. 


INPUT 


INPUT into (ITEM) 


This tells SAVVY to put whatever you type into the specified item. When you are defining a task you might use 
INPUT this way: 


DISPLAY the "WHAT IS YOUR NAME? TYPE IT HERE " 
INPUT into NAME 


In this example, you are expected to type in your name and press the RETURN. SAVVY will wait until you do. 
SAVVY then takes what you entered and puts it in the specified item. The INPUT instruction tells SAVVY to 
expect action at the keyboard and where to put the results of that action. SAVVY will accept the INPUT for an 
item until it receives a RE'URN or 255 characters. 


INTEGER 


This is a standard item that contains the whole number portion of a number that has been SPLIT. 


ITEM 
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An item is a piece of information on a page or in a task. For example, the page whose ID is INVOICE 503 may 
contain a number of items, such as CUSTOMER NAME, CUSTOMER ADDRESS, CUSTOMER PHONE, UNIT PRICE, 
TOTAL PRICE, BALANCE DUE, etc. SAVVY uses certain items in a standard way. For example, SUM, DIFFERENCE, 
PRODUCT, and QUOTIENT are always used to store the results of the Proper arithmetic operati 
important to distinguish between the name of the item and the contents of the item. For exam 
item called CUSTOMER NAME with the contents JOHN SMITH. If you tell SAVVY to: 


ons. It is very 
ple: You have an 


DISPLAY the CUSTOMER NAME 
It will display: JOHN SMITH 
If you tell SAVVY to: 

DISPLAY the "CUSTOMER NAME" 
It will display: CUSTOMER NAME 


The first time you told it to display the contents of the item. In the second, because you used the quotation 
marks, you told it to display the name of the item. 


ITEM is also a command, which allows you make a new word or phrase an item if you are in the FREE mode and do 
not wish to get into LITERAL to create it. 


JANITOR 


JANITOR is cleaning up. Please wait. 


This tells SAVVY to reorganize and repack the information on the diskette as efficiently as possible, to free 

up larger areas for use. You don't have to know anything about what the janitor is doing. This activity could 
have been started automatically, whenever the memory has become so cluttered that cleanup would be helpful . 
However, since the operation may take anywhere from one to ten minutes, and you can't do any work while the 
JANITOR is at work; SAVVY lets you pick the time. You will want to make a habit of calling the janitor every 
time you finish a work session, for example, so that you don't forget to clean up. You may notice that the 
system operates faster when it has been cleaned. When the janitor has finished, SAVVY tells you how much space 


(in thousands of characters) has been cleaned up and is now available. A "room" is a storage area on the disk 
consisting of 1024 characters. 


LABEL 


LABEL this line (LABEL NAME) 


This tells SAVVY how to identify targets for the GO command. NOTE that the label name is a string, and SAVVY 
expects you to put quotation marks around a string. If you forget the quotes, SAVVY won't know what to make of 
what you have just given it. If you tell SAVVY to GO to a Particular label name, instead of moving to the next 
line, it will go to the labeled line and start from that point. The target line may be either before or after 

the line with the GO. If a label name has already been used, SAVVY will tell you so. When you run the task, if 


you have not used the line LABEL, SAVVY will tell you so. The LABEL NAME must be entered in quotation marks 
for SAVVY to recognize it. 
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LAYOUT 
LAYOUT the (ITEM) using format (a literal or ITEM containing format) 


This tells SAVVY how to present the contents of an item on the screen or on a printed page. A literal or the 
contents of an item are used to define the format. By a literal, we mean a specific number that is typed in 
in quotation marks. If you do not want to use a specific format, then you can leave it to SAVVY by typing in 
the word DEFAULT. The DEFAULT convention sets the format to the length of the contents of the item. 


LEAVE 
LEAVE this loop 


This tells SAVVY to stop repeating a loop and start with the next command after END the test. Ordinarily, 
LEAVE will be used when the comparison has met some condition previously set. For example, SAVVY may be told 
to examine every page in the folder INVOICES, and to record the date on each page. SAVVY would start the loop 


at the beginning and get each page in succession until it got to the last page. Within that loop there could 
be this test: 


IF the PAGE IS EMPTY then 
LEAVE this loop 
END of test 


This test tells SAVVY that if the contents of the item PAGE is EMPTY, then it is to LEAVE the loop that it is 
in, and to continue on with the main task. 


LENGTH 


This is an item that SAVVY recognizes. It is not a command. When SAVVY does a CUT, it stores the number of 
characters that are in the item FRONT, in the item LENGTH. When SAVVY does a TAXE, it stores the number of 
characters that are in the item BACK, in the item LENGTH. When SAVVY does a PASTE, the number of characters in 
the item FRONT is stored in the item LENGTH. 


LENGTH OF PROMPT 


This is a standard item that contains the number of characters to be used when displaying the item name when 
you use the command PROMPT. One space is always inserted betweed the end of the item name and the first 
character of the information entered. If the item name is longer than the LENGTH OF PROMPT, the length of the 
item name will be used. 


LENGTH OF SHOW 


This is a standard item that contains the number of characters used to show the item name when you use the 
command SHOW. One space is always inserted between the end of the item name and "is". If the item name is 
longer than LENGTH OF SHOW, the length of the item name will be used. 
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LIMIT 
LIMIT the input for (ITEM NAME) to a maximum of (NUMBER) 


This tells SAVVY to accept only a maximum number of characters for an INPUT. For example, say that you have a 
task that enters customers names and addresses. In that task you will have a step that enters the ZIP CODE. 
Since a ZIP is always 5 numbers long, you could limit the input for zip to 5 characters. That way, you know 
every zip will contain 5 characters. The maximum number that you can use in a LIMIT is 255. If you use Û or a 
number less than 1, SAVVY will automatically use 1. 


NOTE: When you do use LIMIT, you do not use a separate command for INPUT. 


LIST 
LIST the (LISTING NAME) 


This tells SAVVY to display certain listable things on the screen for you. 
Examples: 


LIST the TASKS 
LIST the INDEX in folder DICTIONARY 


Note that using words like LIST will point out the need to remember the use of the RETURN after important 
primary instruction words. Your tendency will be to type: 


LIST TASKS (R) 
Instead of typing: 


LIST (R>) TASKS(R> 


SAVVY would be puzzled by the first way and would ask for clarification if you have not taught it a phrase for 
that purpose. And it is a poor idea to use primary commands like LIST as a part of longer task names or 
associated phrases that you teach to SAVVY, because it can allow extra confusion. The LISTING NAMES you can 
use are: Tasks, Items, Folders, Associations, Undefined names and the Index of a folder. 


LITERAL 
LITERAL...I'Il make no assumptions 


This tells SAVVY to pay strict attention to what you type in. When you tell SAVVY this, you are telling it 

that you are going to teach it something new and that you want it to pay close attention. In the LITERAL mode, 
SAVVY cannot understand misspelled words, or try to figure out what you mean if you do not enter something the 
way that it was entered originally. This is the exact Opposite of FREE. 


LOOP 


This is a term meant for you, not for SAVVY. It refers to a repeating sub-task that SAVVY can set the computer 
to doing. Unless you teach it to do something, SAVVY will not respond to the command LOOP. To start a LOOP, 


you use the command START. To REPEAT a LOOF, you use the command REPEAT. To stop the LOOP, you use either 
HALT or LEAVE. 
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MULTIPLY 


NO 


MULTIPLY the (CLEMENT) by (ELEMENT) 


This tells SAVVY to multiply two numbers and to store the results in the item PRODUCT. The numbers to be 
multiplied may be values that you enter from the keyboard or values that are stored in an item. For example: 


MULTIPLY the HOURS by PAY RATE 


This multiplies the contents of the item HOURS by the item PAY RATE, and stores the answer in PRODUCT. If a 
number or the product is too long to handle, SAVVY will tell you so. 


This is a standard item that contains the string "N". It is most often used in an IF statement. For example: 


IF the ANSWER IS NO then 


That step would have SAVVY compare the contents of ANSWER with the CONTENTS of NO. If they were the same, then 
it would do the next step. 


OTHERWISE 


OTHERWISE Ç 


This tells SAVVY to proceed with more work before ending a test. An example of OTHERWISE working inside a task 
would be: 


Does IF the ANSWER IS 5 then 

Do CLEAR the page 

and OTHERWISE 

Do TELL ME WHAT YOU KNOW 
and END of test 


The use of the OTHERWISE here saves an extra test in the task. OTHERWISE lets the process continue without 
further testing if the contents of the item ANSWER are something other than 5. Without OTHERWISE, you'd have 
to set up the task something like this: 


Does IF the ANSWER IS 5 then 
Do CLEAR the page 
and END of test 
and IF the ANSWER IS NOT 5 then 
Do TELL ME WHAT YOU KNOW 
and END of test 


This is a simple example. In more complex tasks, OTHERWISE saves more work. OTHERWISE can also be used with 
the command WHEN. 
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OUTPUT 
OUTPUT from (ELEMENT) using format (FORMAT NAME) 


This tells SAVVY to put out the specified element on whatever output device (video, printer, communications 
device) is currently in service. In addition, it allows you to specify a format for contents of the item that 
is different from the current format of the contents of the item. If you do not specify a new format (typing a 


blank for the format name), SAVVY will use the existing format in the item. SEE LAYOUT FOR A DISCUSSION OF 
FORMAT. 


OUTPUT does not permanently alter the format of the contents of the item. It applies the specified format only 
to this single instance of output. 


PAGE 


A page is an electronic version of an ordinary piece of paper with information written on it. A page is 
identified by its ID. A page may be also identified to SAVVY with one of these words: FIRST, PREVIOUS, NEXT, 
LAST, or THIS. If SAVVY is working through a folder full of invoices, for example, the invoices are probably 


indexed by invoice number as they are usually in ordinary business use. When SAVVY has finished with one page, 
you may want to be able to say: 


GET the page indexed by NEXT in folder INVOICES 


or 


DELETE the page indexed by THIS from folder INVOICES 
or so on, without having to give the ID of the page every time. 


PAGE is also an item that is used when you are working with folders. When SAVVY gets the last page from a 
folder it copies the contents of EMPTY to the item PAGE. That allows you to make a comparison that will have 
SAVVY stop repeating a loop if the comparison is true. 


PAPER 
PAPER selected... 


This tells SAVVY to print the material you call for next. Por example, you might select PAPER and then DETAIL 
this (TASK NAME), and the task would be detailed on paper and not on the screen. SAVVY automatically returns 


back to working on the screen. To do more than one thing on paper, you need to select paper before every one 
you want on paper. 


PASTE 
PASTE the (ELCMENT) in front of (ELEMENT 


This tells SAVVY to paste two things together. The result is stored in the item FRONT. The number of 
characters in FRONT is stored in the item LENGTH. For example, if you are defining a task to create the ID for 


a folder, and you want the ID to be a customer's name in the sequence LAST NAME,FIRST NAME, then you would 
have the steps: 


PASTE the LAST NAME in front of "," 
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PASTE the FRONT in front of FIRST NAME 


You could then copy the FRONT to the (FOLDER NAME) ID. 


POSITION 


This is a word for you. It does not have any special meaning to SAVVY. It deals with the locations of 
information in the folder. SAVVY recognizes these positions: 


FIRST 
NEXT 
THIS 
PREVIOUS 
LAST 


To show you what SAVVY recognizes as these positions assume that you have the following ID's in the folder 


INVOICES: 1011, 1012, 1013, 1014, 1015, 1016, 1017, 1018. In the folder they might look like this with the 
letters denoting the positions. 


A 
B 1011 
1012 
1013 
1014 C 
1015 
1016 
1017 


D 1018 
E 


The letter A would show the position FIRST. In relation to the position FIRST, the letter B would denote NEXT. 
Now in relation to the letter B, '1012' would be NEXT. The letter E would denote the position LAST, and in 
relation to that, the letter D would denote the position PREVIOUS. Now in relation to the letter D, the '1017' 
would be PREVIOUS. now the position THIS refers to a position where you presently are in the folder. In the 


above example, say that you were looking at '1014,' and you wanted to delete the page. You would use the 
command: 


DELETE page indexed by THIS from folder INVOICES. 


PRESERVE 
PRESERVE the data base 


This tells SAVVY to collect the information you have typed but which is not yet stored on the disk and to 

record it on the disk. This has to do with the nature of the computer system. Everything you type in is stored 

first on the temporary memory inside the computer itself. Only when the temporary memory is filled or when 

deliberate steps are taken, will SAVVY transfer the material to the relative safety of the disk. If there is a 

glitch of some kind in the electrical power, you may lose what's on the temporary memory and have to reenter 2 
that information. The temporary memory in the APPLE is big enough to make reentering a tedious chore if the — 
glitch occurs when the temporary memory is only partially full. 
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PRESERVE lets you dump fresh data from the temporary memory onto the disk whenever you think it is worthwhile. 
(NOTE that SAVVY automatically transfers tasks, folders, and other structures to the disk as soon as they are 
available, providing extra protection to those important things.) 


SAVVY automatically does a PRESERVE before it shows the 'ready' message "What would you like me to do now?” 


PRINT 
PRINT the (ELEMENT NAME or KEYBOARD ENTRY) 


This tells SAVVY to print the specified material. This also tells the system that the printer is the current 


output device. If the material that you want printed is a keyboard entry, you need to put it in quotation 
marks. Like this: 


PRINT the "CUSTOMER NAME" 
SAVVY would respond by printing CUSTOMER NAME 
But if you were to enter it this way 

PRINT the CUSTOMER NAME 


SAVVY would respond by printing the contents of CUSTOMER NAME 


PRODUCT 


This is a standard item in which the result of a MULTIPLY is stored. 


PROMPT 
PROMPT for (ITEM NAME) 


This tells SAVVY to ask for the information to store in a particular item and then to store your input in that 


item. For example, if you had a folder called CUSTOMERS, you would need a task to add to that folder. In that. 
task you might have these steps: 


PROMPT for FIRST NAME 
PROMPT for LAST NAME 
PROMPT for ADDRESS 

When you used that task, it would display: 


Enter FIRST NAME: 


SAVVY would wait for you to enter the first name and press the RETURN. SAVVY 
would then store the information in the item FIRST NAME and display: 


Enter LAST NAME 


and so on. 
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QUOTIENT 


This is the standard item in which SAVVY stores the results of a DIVIDE. 


READ 
READ the cursor position line into (ITEM NAME) and character into (ITEM NAME) 


This tells SAVVY to put the cursor line number into an item, and the cursor character number into an item. 
This is the opposite of the command CURSOR. 


RENAME 
RENAME old name (ITEM NAME) to new name (ITEM NAME) 


This tells SAVVY to change the name of an item, task, function, or folder. If the item is secure, SAVVY won't 


change its name. If the new name you select is already in use, SAVVY will not accept it. SAVVY cannot RENAME 
an association. SEE FORGET. 


REPEAT 
REPEAT this loop 


This tells SAVVY to go back to the START of the loop and start all over again. Note that you may tell SAVVY to a 


do loops within loops, but if you do you will want to remember which loop you are talking about. 


REPLACE 
REPLACE this page in (FOLDER NAME) 


This tells SAVVY to put a page you have been working with and have changed some information on, back in the 
folder from which it came. When SAVVY takes a page out of a folder for you, it really takes a copy of it. If 


you damage or lose that copy, the original is still in the folder. However, if you change anything on the page 
you will want to replace the old one in the folder with the new one. If you change the ID of the page, you 
cannot replace it, because it has become a new page from SAVVY's point of view. In that case, you must use the 
command SAVE to save the new page, and the command DELETE to remove the old one. 


RESIDUE 
RESIDUE is what is left of a phrase after SAVVY has picked out what it considers the primary meaning of the 
phrase. (RESIDUE won't come to your attention unless you are doing some advanced work with SAVVY.) For 
example, you have typed in: 
Does Bill Smith work here? 
SAVVY examines the whole line and decides that it is most like this phrase it has seen before: 


Does X work here? 


At first glance, SAVVY has extracted the pattern 
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Does...work here? 


That pattern is associated with a task instructing SAVVY to go through the folder containing the names of all 
the employees and report the presence or absence of name X. Those instructions also tell SAVVY to look in the 
RESIDUE for the name represented by X. In this case, SAVVY finds "Bill Smith " in the RESIDUE. It then 
searches for that name in the employee list. 


RESIDUE may be long and full of interesting things that SAVVY can use for various purposes. Note also, that 
the example used here is extraordinarily simple and does not illustrate SAVVY's pattern recognition 
capabilities. (Almost any system could be programmed to pick 'Does...work here?' out of a line and do 
something with it. SAVVY does far more.) The example merely illustrates RESIDUE. 


RETURN 
RETURN to the previous task 


This tells SAVVY to leave the task it is in at the moment and RETURN to the larger task of which it is a part. 
SAVVY assumes you want a RETURN at the end of every task you define, and if you don't put the RETURN in 
yourself, SAVVY will act as if you did. The effect is that when SAVVY completes a task for you, it doesn't 
just stop in its tracks, but returns you to the previous task. In the simplest case, that sends you back to 


the 'Ready' message. However if the task is running as part of another task, SAVVY returns you to the larger 
task. 


Example: 


You are running PAYROLL. One of the subtasks in PAYROLL is called COUNT CHECKS. When SAVVY 


completes the task COUNT CHECKS, it returns to that point in the task PAYROLL and then does 
the next step in PAYROLL. 


If the RETURN is automatic, why do you need RETURN in the vocabulary you will use in giving instructions to 
SAVVY? Because there are times when you want to induce the RETURN without waiting to work through the 
remainder of a long task. The loop might test for some condition, find that it already serves the purpose, and 


then RETURN to the main task. That's why you want a RETURN that you can put in yourself, instead of leaving it 
to SAVVY by default. 


RING 
RING bell 


This tells SAVVY to make an audible 'beep.' The signal could be used to call you to examine the results of 
SAVVY'S work and OK it before SAVVY proceeds to the next step. 


SAVE 
SAVE new page in (FOLDER NAME) 


This tells SAVVY to put a new page in the specified folder. SAVVY won't do it if the ID of the page it is 
trying to save is the same as one already in the folder. Each page must have a unique ID. 


(If you are working with invoices, a sensible choice of ID's may be the invoice number. It is helpful to have 
SAVVY refuse to accept duplicate invoice numbers, because that identifies an error for you. If you use the 
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customer's name and the date as the ID you may find that several 'John Smith's' are among your customers, and 
several of them did business with you on the same day. SAVVY has other ways to solve this for you.) 


Unique indexes are often confused with duplicate references. A duplicate reference will still have a unique 
index. The way SAVVY handles this is to join a number to the additional references so that no matter how many 
duplicates there are, each has its own separate page in the folder. 


The ROBOT PROGRAMMER handles duplicates this way. For example, say that you have 6 John Smith's for customers. 
You have a folder titled CUSTOMERS in which you keep all of your customer information. The ID for the page is 
the customer name. When you did the write programs for this folder you told SAVVY that it was OK to have 
duplicate references. When you entered these John Smith's to the folder, SAVVY gave the first one entered the 

ID John Smith, the second one the ID John Smith 1000, the third the ID John Smith 1001, and so on. When you 
view the folder, all you see is the customer's name, not the numbers, because the number is a part of the ID 

and the ID is not one of the items shown. You can copy, from the DEMO disk, the way this task is written; and 
use it when you are defining a task that makes the folder ID's. 


SECURE 
SECURE the (TASK NAME or FOLDER NAME) to level (NUMBER) using password (ELEMENT) 


This tells SAVVY to protect any task, item, or folder from access by an operator who does not have the 
password. SAVVY lets you secure things to four different levels: 


Level 0--provides no security. Anybody may use, edit, 
or detail the task, item, or folder. C. 


Level 1--allows anybody to use the task, item, or 
folder; but does not allow anybody to 
edit or detail the task, item, or folder 
without the correct password. 


Level 2--allows no use, editing, or detailing 
without the password; but if you DETAIL 
the TASKS, the secured task will be 
detailed also. 


Level 3--this is a combination of level 1 and 2 
for maximum protection. 


NOTE: SAVVY's primary vocabulary is SECURE to level 1. 


Vhen you SECURE something, you set the level and select the password. In effect you are locking it up and the 
password will be your key. 


When you want to use whatever you have secured, you use the same procedure and SECURE it down to level 1 or 0. 
To keep it safe, you need to SECURE it again once you are finished with it. 


You can do all surts of clever things with passwords, hiding the word or words in an item somewhere, so that 

you can find the password when you need to, but nobody else knows where to look. Be careful not to fool '— 
yourself, and be locked out from the material you really need. Clearly it is risky to secure things. It 

should never be done until you have appropriate documentation and backups for safety. 


J 
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SHOW 
SHOW the (ITEM) 


This tells SAVVY to show the name and the contents of the specified item on the screen. Example: 
You type: 

SHOW the SUM 
SAVVY displays: 

SUM is 5 
You type: 

SHOW the CUSTOMER NAME 
SAVVY displays: 

CUSTOMER NAME is John Smith 

SPLIT 
SPLIT the number (ELEMENT) 


This tells SAVVY to split a number into two parts . The first part will be the whole number, before the 
decimal point. The second part will be the fraction, after the decimal point. The whole number is put in the 
item INTEGER, the decimal is put in the item FRACTION. 
EXAMPLE: 
SPLIT the number 123.454 
When you type: 
DISPLAY the INTEGER 
SAVVY responds by displaying: 
123 
Vhen you type: 


DISPLAY the FRACTION 


SAVVY responds by dispiaying: 
456 
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START C 
START a loop 


This tells SAVVY where to start a loop, and it also denotes the place that SAVVY will return to each time the 
Ioop is repeated. 


STRING 


A string is a series of characters preceded by a quotation mark. When SAVVY encounters a quotation mark, it 
does not try to analyze the characters or look for an instruction. It merely counts through them and puts a 
quotation mark at the end for you. If you include a closing quote, SAVVY will insert another one for you 
because it doesn't analyze the characters, it just records them. Strings are used most commonly in the context 


of tasks and functions. Textual information entered into a folder does not have to be preceded by a quotation 
mark. 


SUBTRACT 
SUBTRACT the (ELEMENT) from (ELEMENT) 


This tells SAVVY to subtract the first element from the second and to store the answer in the item DIFFERENCE. 


SUMMON 
SUMMON the standby task (TASK) 


This tells SAVVY to load the special systems program needed for a particular kind of work. 


For example, not all tasks are maintained inside the computer's active memory, because the memory available 
inside the Apple is small, and SAVVY is constantly swapping information in and out. You don't want to crowd 


that memory with the code for programs that are used infrequently. You tell SAVVY to SUMMON the programs when 
they are really needed. 


Currently, SAVVY has these standby tasks: 


ARCHIVE (copies diskettes) 

DIAGNOSTICS (a utility program to identify problems) 

CONFIGURATOR (prompts you for the information the system needs about itself--what kind 
of printer interface you are using serial or parallel--and so on) 


TAKE 
TAKE this many characters (NUMEER) from (ELEMENT) 


This tells SAVVY to divide an element into two parts after a specific number of characters. The part on the 
left is put into the item FRONT; the part on the right is put in the item BACK. The number of characters in 
BACK is stored in LENGTH. Note that TAKE differs from CUT in that in the command CUT you use a specific 
character and in TAKE you use a specific number of characters. 
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TASK 


A task is the description of a job that SAVVY can do. SAVVY 
SAVVY's understanding of the program is determined by the task. This word does not call for action from SAVVY, 
and it is not the name of an item (unless you make it so, which is probably a bad idea, because it will be 


confusing later on). Tasks are globally accessible. That means you may use the task name inside of another 
task, without having to type in each of the steps all over again. 


codes a program from such a description, and 


THAW 
THAW the (ELEMENT) 


This tells SAVVY to allow a change in the contents of a frozen item, task, or folder. SEE FREEZE. 


USAGE 
USAGE of the disk is such that % of the 140 rooms are in use 


This command tells SAVVY to report on the amount of memory used. SAVVY stores information on the disk in 140 
"rooms" of 1024 characters each. When you type USAGE, SAVVY's report tells you the percentage of rooms in use. 


WHEN 
WHEN folder (FOLDER NAME) (CONTENTS) (ELEMENT) then 
(TASK NAME) 


This tells SAVVY to take a particular action if the folder specified contains the element specified. 


Please note that WHEN is like IF, but WHEN deals with the CONTENTS and the IF deals with COMPARISONS. This 
instuction does not include a comparison, but the point is to base an action on the contents of a folder. 


You must tell SAVVY when you have reached the end of the WHEN statement, just as you do with the IF statement, 
by using the command END. 


WORDING 
WORDING for prompts of function (FUNCTION NAME) 


This tells SAVVY that you want to change the prompts for an existing function. See FUNCTION. 


YES 


This is a standard item that contains the string "Y^. 
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LIMITS 
EEE EOE a Ad pl mia Euer le 10 mega bytes 
Largest possible number........ +/-99,999,999,999,999,999,999,999,999 
Smallest possible number.............. +/-.00000000000000000000000001 
No binary rounding errors............. Decimal arithmetic 
Largest number of pages in a folder....................ooooo.o.... 20,000 
Maximum number of bytes per pagée................. cece cece uu. 1000 
Mannon Minber ‘Of fold6Ig a dd 10,000 
Maximum number of items per page............... 0... ccc cece ee eee 254 
Maximum number of bytes per 10612: cc cece eee eeee 255 
FESDIRON Fey SENG ch a a tiie ENS 255 bytes 
Maximum number of bytes for a nonfolder item..................... 1000 C 
Maximum number of levels of recursion............................ 64 
Maximum number of bytes per name.................... ge as 32 


Maximum number of arguments per function 
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pm 
` 
FACTORY LEARNING 

When you create a "Clean data disk", it will contain the following 
data from the education SAVVY was given at the factory: 
PRIMARIES 
ADD ASSIGN BEGIN CARRIAGE CLEAR 
COPY CURSOR CUT DELETE DISPLAY 
DIVIDE DO DUPLICATE END ERASE 
FILL FREEZE GENERATE GET GO 
HALT IF INPUT LABEL LAYOUT 
LEAVE LIMIT MULTIPLY OTHERWISE OUTPUT 
PASTE PRESERVE PRINT PROMPT REPEAT 
REPLACE RETURN RING SAVE SECURE 
SHOW SPLIT START SUBTRACT SUMMON 
TAKE THAW WHEN WORDING 
COMMANDS 
ASSOCIATE CREATE DEFINE DETAIL FORGET 

pem FREE FUNCTION ITEM JANITOR LIST 
LITERAL PAPER RENAME USAGE 
ITEMS 
ANSWER BACK DIFFERENCE DISK TITLE 
EMPTY ERROR FRACTION FRONT ID 
INTEGER LENGTH LENGTH OF PROMPT LENGTH OF SHOW 
NO PAGE PRODUCT QUOTIENT RESIDUE 
SUM Tmp01 Tmp02 Tmp03 Tmp04 
Tmp05 Tmp0é Tmp07 Tmp08 Tmp09 
Tmpi0 Tmp11 Tmp12 Tmp13 Tmp14 
Tmpis 1۳816 Tmpi7 Tmp18 Tmp1 9 
Tmp20 VERSION YES 
FOLDERS 
DICTIONARY 
TASKS 
REPORT ASSICN ERROR (Undefined) 

( REPORT DELETE ERROR (Undefined) 

REPORT GET ERROR (Undefined)‏ پم 
REPORT MATH ERROR (Undefined)‏ 


REPORT REPLACE ERROR (Undefined) 
REPORT SAVE ERROR (Undefined) 
STARTUP (Undefined) 
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C 


WHAT TO DO IF..... 


This section is a guide to use for some of the problems that may occur when using the SAVVY language. It is not 
meant to be a comprehensive answer to all of the questions that might arise, but a guide to get you started in 
an attempt to solve your problems. If these guides do not solve the problem, consult you local Apple dealer or 
your local SAVVY dealer to get the technical expertise that is needed. It covers the following: 


1. NOTHING COMES UP ON THE SCREEN 
2. DISK IN TROUBLE message 
3. SCREEN COMES UP HI 
4. WON'T SUMMON STANDBY TASKS: CONFIGURATOR, 
DIAGNOSTICS, ARCHIVE 
$. READ ERROR-WRITE ERROR 
6. ERROR IN SAVE 
7. ERROR IN GET 
8. PRINTER WON'T WORK 
9. SAVVY DOES NOT RECOGNIZE THE PRIMARY COMMANDS 
10. BAD ID 
11. 1/0 ERROR 
12. NO POWER 
13. Unfinished LOOPs, IFs or WHENs remain! 
Please fix them! 
14. TROUBLE BACKSPACING 
15. THE CURSOR DOES NOT MOVE C 


WHEN NOTHING COMES UP ON THE SCREEN 


Things to check when the screen comes up blank: 
(this assumes that the computer is turned on) 


Is the monitor on? 

Is the cable from the monitor to the computer plugged 
in properly? 

Are the diskettes in the proper drives? 

Is the SAVVY card in slot 7? 

Are you trying to use diskettes configured for the 
VIDEX in the NATIVE mode? 


Are you trying to use diskettes configured for NATIVE 
with a VIDEX card? 


If you think that the disks have been 

configured for videx and you are using 

native, you can reconfigure them with 

a little patience. You will work with 

a blank screen, just act like the messages 

that are supposed to come up on the screen 

are there. Follow the steps outlined in 

the ezplanation of configuring the system. 

You may have to do it more than once to سم‎ 
get it, but you can do it. 
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If this doesn't fiz it take to your nearest Apple dealer 
for proper servicing. 
UNFINISHED LOOPs, IFs, OR WHENs REMAIN! PLEASE FIX THEM! 
This message occurs when you are defining a task and you have not completed a LOOP, IF, or WHEN command. To do 
( that, you need an END command for every IF and WHEN; and you need a REPEAT for every START of a loop. 
TROUBLE BACKSPACING 
This ususally occurs when you are trying to backspace over a long string of characters. SAVVY will allow you 
to backspace over 32 at one time. After you enter the 33rd character, you cannot backspace past number 33. You 
can backspace back from character 50 to character 33 though. 
THE CURSOR DOES NOT MOVE 
This occurs usually in a task that involves using the printer and the printer is not turned on. First turn on 
the printer then make sure the printer is on line. If nothing happens still, turn off the computer. Then turn 
it back on and try to go back to that same point and see if it happens again. If it does, repeat the off and 
on process, and then try DIAGNOSTICS. If DIAGNOSTICS checks OK, detail the task that is being done at the time 
it hangs up, and see if that is the cause. 
< 
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